sevdesk-mcp is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by codestra. MCP server for sevDesk - enables AI assistants to interact with sevDesk's accounting, invoicing, and contact management API. It has 6 GitHub stars.

Is sevdesk-mcp safe to use?

sevdesk-mcp's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.

How do I install sevdesk-mcp?

Clone the repository with "git clone https://github.com/codestra/sevdesk-mcp" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is sevdesk-mcp written in?

sevdesk-mcp is primarily written in TypeScript. It is open-source under codestra on GitHub, so you can review or fork the full source.

Are there alternatives to sevdesk-mcp?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh sevdesk-mcp against similar tools.

sevdesk MCP Server v2.0

Name: sevdesk-mcp
Author: codestra

A comprehensive Model Context Protocol (MCP) server for integrating with the sevdesk German accounting and bookkeeping API. Features 76 tools for full CRUD operations across all major sevdesk resources.

Features

Contact Management - Full CRUD for customers, suppliers, and partners
Invoice Handling - Create, send, and manage sales invoices with line items
Expense Tracking - Manage vouchers/receipts with booking and enshrinement
Order Management - Handle offers, order confirmations, and delivery notes
Credit Notes - Full credit note lifecycle management
Products & Services - Manage parts catalog with stock tracking
Bank Integration - Accounts, balances, and transaction management
Tags & Categories - Organize records with tags
Contact Details - Addresses and communication ways (email, phone)
PDF Generation - Download PDFs for invoices, orders, and credit notes
Email Sending - Send documents directly via email

Prerequisites

Node.js 18 or higher
pnpm (recommended) or npm
A sevdesk account with API access

Installation

git clone https://github.com/sajadghawami/sevdesk-mcp.git
cd sevdesk-mcp

# Install dependencies (choose one)
pnpm install   # or: npm install | yarn install

# Build
pnpm build     # or: npm run build | yarn build

Configuration

Getting Your API Token

Log in to your sevdesk account at my.sevdesk.de
Navigate to Settings → Users → API Token
Generate or copy your API token

Claude Desktop

Add to your claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "sevdesk": {
      "command": "node",
      "args": ["/path/to/sevdesk-mcp/build/index.js"],
      "env": {
        "SEVDESK_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Claude Code

Add to .mcp.json in your project directory (project-specific) or ~/.claude/.mcp.json (global):

{
  "mcpServers": {
    "sevdesk-mcp": {
      "command": "node",
      "args": ["/path/to/sevdesk-mcp/build/index.js"],
      "env": {
        "SEVDESK_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Available Tools (76 total)

Contacts (6 tools)

Tool	Description
`list_contacts`	List customers, suppliers, and partners
`get_contact`	Get detailed contact information by ID
`create_contact`	Create a new contact
`update_contact`	Update existing contact
`delete_contact`	Delete a contact
`get_next_customer_number`	Get next available customer number

Invoices (14 tools)

Tool	Description
`list_invoices`	List sales invoices with filters
`get_invoice`	Get invoice details by ID
`create_invoice`	Create invoice with line items
`update_invoice`	Update existing invoice
`delete_invoice`	Delete an invoice
`get_invoice_pdf`	Get invoice PDF as base64
`send_invoice_email`	Send invoice via email
`change_invoice_status`	Change invoice status
`book_invoice_payment`	Record a payment
`list_invoice_positions`	List invoice line items
`get_invoice_position`	Get position details
`create_invoice_position`	Add line item
`update_invoice_position`	Update line item
`delete_invoice_position`	Delete line item

Vouchers (12 tools)

Tool	Description
`list_vouchers`	List expense vouchers/receipts
`get_voucher`	Get voucher details by ID
`create_voucher`	Create expense voucher
`update_voucher`	Update existing voucher
`delete_voucher`	Delete a voucher
`book_voucher_payment`	Record payment on voucher
`enshrine_voucher`	Finalize/lock a voucher
`list_voucher_positions`	List voucher line items
`get_voucher_position`	Get position details
`create_voucher_position`	Add line item
`update_voucher_position`	Update line item
`delete_voucher_position`	Delete line item

Orders (13 tools)

Tool	Description
`list_orders`	List orders (offers, confirmations)
`get_order`	Get order details by ID
`create_order`	Create order with line items
`update_order`	Update existing order
`delete_order`	Delete an order
`get_order_pdf`	Get order PDF as base64
`send_order_email`	Send order via email
`change_order_status`	Change order status
`list_order_positions`	List order line items
`get_order_position`	Get position details
`create_order_position`	Add line item
`update_order_position`	Update line item
`delete_order_position`	Delete line item

Credit Notes (12 tools)

Tool	Description
`list_credit_notes`	List credit notes
`get_credit_note`	Get credit note by ID
`create_credit_note`	Create credit note
`update_credit_note`	Update credit note
`delete_credit_note`	Delete credit note
`get_credit_note_pdf`	Get PDF as base64
`send_credit_note_email`	Send via email
`list_credit_note_positions`	List line items
`get_credit_note_position`	Get position
`create_credit_note_position`	Add line item
`update_credit_note_position`	Update line item
`delete_credit_note_position`	Delete line item

Bank Accounts (6 tools)

Tool	Description
`list_check_accounts`	List all bank accounts
`get_check_account`	Get account details
`get_check_account_balance`	Get balance at date
`create_check_account`	Create bank account
`update_check_account`	Update account
`delete_check_account`	Delete account

Transactions (5 tools)

Tool	Description
`list_transactions`	List bank transactions
`get_transaction`	Get transaction details
`create_transaction`	Create transaction
`update_transaction`	Update transaction
`delete_transaction`	Delete transaction

Parts/Products (6 tools)

Tool	Description
`list_parts`	List products/services
`get_part`	Get part details
`create_part`	Create product/service
`update_part`	Update part
`delete_part`	Delete part
`get_part_stock`	Get current stock level

Tags (8 tools)

Tool	Description
`list_tags`	List all tags
`get_tag`	Get tag details
`create_tag`	Create new tag
`update_tag`	Update tag
`delete_tag`	Delete tag
`list_tag_relations`	List tagged objects
`add_tag_to_object`	Tag an object
`remove_tag_from_object`	Remove tag

Contact Addresses (5 tools)

Tool	Description
`list_contact_addresses`	List addresses
`get_contact_address`	Get address details
`create_contact_address`	Create address
`update_contact_address`	Update address
`delete_contact_address`	Delete address

Communication Ways (5 tools)

Tool	Description
`list_communication_ways`	List email/phone entries
`get_communication_way`	Get details
`create_communication_way`	Create entry
`update_communication_way`	Update entry
`delete_communication_way`	Delete entry

Development

Build Commands

# Install dependencies
pnpm install

# Build the TypeScript source
pnpm build

# Start the server
pnpm start

# Watch mode for development
pnpm dev

Project Structure

sevdesk-mcp/
├── src/
│   ├── index.ts           # MCP server entry + 76 tool registrations
│   ├── api.ts             # HTTP client (GET/POST/PUT/DELETE/PDF)
│   ├── types.ts           # TypeScript interfaces (20+ types)
│   └── tools/
│       ├── contacts.ts    # Contact CRUD
│       ├── invoices.ts    # Invoice CRUD + PDF/email/status/positions
│       ├── vouchers.ts    # Voucher CRUD + book/enshrine/positions
│       ├── accounts.ts    # Bank account + transaction CRUD
│       ├── orders.ts      # Order CRUD + PDF/email/positions
│       ├── creditnotes.ts # Credit note CRUD + PDF/email/positions
│       ├── parts.ts       # Part CRUD + stock
│       ├── tags.ts        # Tag + TagRelation CRUD
│       ├── addresses.ts   # Contact address CRUD
│       └── communication.ts # Communication way CRUD
├── build/                 # Compiled JavaScript output
├── package.json
└── tsconfig.json

API Reference

This server integrates with the sevdesk REST API. For complete API documentation, see:

sevdesk API Documentation
API Base URL: https://my.sevdesk.de/api/v1

License

ISC

sevdesk-mcp

Frequently Asked Questions

What is sevdesk-mcp?