You can use this MCP server to manage sevdesk accounting data through Claude or other MCP-compatible clients.
Create, list, retrieve, update, and delete contacts (customers, suppliers, partners).
List, retrieve, export as PDF, email, mark as sent, book as paid, and cancel invoices.
List, retrieve, book, inspect positions for, and upload files to vouchers.
List and retrieve bank accounts, check balances, and list/create/retrieve transactions.
List, retrieve, create, update, and check stock for parts/products/services.
List, retrieve, create, update, and delete tags, and list tag relations.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@sevdesk MCP Server list my unpaid invoices"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Ein MCP (Model Context Protocol) Server für die sevdesk API. Ermöglicht die Integration von sevdesk-Buchhaltungsfunktionen in Claude und andere MCP-kompatible Anwendungen.
Kontakte: Erstellen, lesen, aktualisieren und löschen von Kontakten (Kunden, Lieferanten, Partner)
Rechnungen: Auflisten, abrufen, als PDF exportieren, per E-Mail versenden, buchen und stornieren
Belege (Voucher): Verwalten von Eingangsrechnungen und Ausgaben
Bankkonten: Verwalten von Bankkonten und Transaktionen
Artikel: Verwalten von Produkten und Dienstleistungen
Related MCP server: sevdesk-mcp
npm install
npm run generate-types
npm run buildSetze die Umgebungsvariable SEVDESK_API_TOKEN mit deinem sevdesk API-Token:
export SEVDESK_API_TOKEN="dein-32-zeichen-hex-token"Den API-Token findest du in sevdesk unter: Einstellungen → Benutzer → API-Token
Füge den Server zu deiner Claude Desktop Konfiguration hinzu (~/.config/claude/claude_desktop_config.json):
{
"mcpServers": {
"sevdesk": {
"command": "node",
"args": ["/pfad/zu/mcp-sevdesk/dist/index.js"],
"env": {
"SEVDESK_API_TOKEN": "dein-api-token"
}
}
}
}SEVDESK_API_TOKEN="dein-token" npm startTool | Beschreibung |
| Alle Kontakte auflisten |
| Einzelnen Kontakt abrufen |
| Neuen Kontakt erstellen |
| Kontakt aktualisieren |
| Kontakt löschen |
Tool | Beschreibung |
| Alle Rechnungen auflisten |
| Einzelne Rechnung abrufen |
| Rechnung als PDF abrufen |
| Rechnung per E-Mail versenden |
| Rechnung als versendet markieren |
| Rechnung als bezahlt buchen |
| Rechnung stornieren |
Tool | Beschreibung |
| Alle Belege auflisten |
| Einzelnen Beleg abrufen |
| Beleg als bezahlt buchen |
| Belegpositionen abrufen |
| Belegdatei hochladen |
Tool | Beschreibung |
| Alle Bankkonten auflisten |
| Einzelnes Bankkonto abrufen |
| Kontostand abrufen |
| Transaktionen auflisten |
| Einzelne Transaktion abrufen |
| Neue Transaktion erstellen |
Tool | Beschreibung |
| Alle Artikel auflisten |
| Einzelnen Artikel abrufen |
| Neuen Artikel erstellen |
| Artikel aktualisieren |
| Lagerbestand abrufen |
Dieser Server basiert auf der offiziellen sevdesk API v1. Weitere Informationen zur API findest du in der sevdesk API-Dokumentation.
Nach npm ci --ignore-scripts und npm run generate-types führt npm run test:offline Build und MCP-Protokolltests aus. Alle 34 Tools werden mit synthetischem Token und abgefangenem HTTP geprüft, einschließlich Schreibaktionen, ungültigen Eingaben und API-Fehlern. Es werden keine echten Kontakte, Rechnungen oder Buchungen verändert und keine E-Mails versandt.
CI prüft dies unter Node 22 und 24 sowie mit npm audit --audit-level=moderate. npm test bleibt die bestehende Integrationstestsuite; ihre Tests werden ohne SEVDESK_API_TOKEN übersprungen und ersetzen keine Offline-Prüfung.
MIT
Book an invoice (mark it as paid)
Inputs: date (required), type (required), amount (required), invoiceId (required), +3 more.
Book a voucher (mark it as paid)
Inputs: date (required), type (required), amount (required), voucherId (required), +3 more.
Cancel an invoice (creates a cancellation invoice)
Inputs: invoiceId (required).
Create a new contact in sevdesk
Inputs: categoryId (required), name, surename, familyname, +2 more.
Create a new part (product/service) in sevdesk
Inputs: name (required), stock, unitId, taxRate, +4 more.
Create a new tag and attach it to a document (Invoice, Voucher, Order, or CreditNote)
Inputs: name (required), objectId (required), objectName (required).
Create a new transaction in a check account
Inputs: amount (required), valueDate (required), checkAccountId (required), entryDate, +4 more.
Delete a contact from sevdesk
Inputs: contactId (required).
Delete a tag from sevdesk
Inputs: tagId (required).
Get a specific check account by ID
Inputs: checkAccountId (required).
Get the current balance of a check account
Inputs: checkAccountId (required), date.
Get a specific contact by ID from sevdesk
Inputs: contactId (required).
Get a specific invoice by ID from sevdesk
Inputs: invoiceId (required).
Get the PDF of an invoice as base64 encoded string
Inputs: invoiceId (required), download, preventSendBy.
Get a specific part by ID
Inputs: partId (required).
Get the current stock of a part
Inputs: partId (required).
Get a specific tag by ID
Inputs: tagId (required).
Get a specific transaction by ID
Inputs: transactionId (required).
Get a specific voucher by ID from sevdesk
Inputs: voucherId (required).
Get all positions (line items) of a voucher
Inputs: voucherId (required).
List all check accounts (bank accounts) from sevdesk
Inputs: limit, offset.
List all contacts from sevdesk. Supports filtering by various parameters.
Inputs: name, depth, limit, offset, +1 more.
List all invoices from sevdesk. Supports filtering and pagination.
Inputs: limit, offset, status, endDate, +2 more.
List all parts (products/services) from sevdesk inventory
Inputs: name, limit, offset, partNumber.
List all tag relations (shows which documents have which tags)
Inputs: no named parameters.
List all tags from sevdesk
Inputs: id, name.
List all transactions of a check account
Inputs: checkAccountId (required), limit, offset, endDate, +3 more.
List all vouchers (receipts/expenses) from sevdesk
Inputs: limit, offset, status, endDate, +3 more.
Mark an invoice as sent
Inputs: invoiceId (required), sendType, sendDraft.
Send an invoice via email
Inputs: text (required), subject (required), toEmail (required), invoiceId (required), +4 more.
Update an existing contact in sevdesk
Inputs: contactId (required), name, surename, familyname, +2 more.
Update an existing part in sevdesk
Inputs: partId (required), name, stock, taxRate, +4 more.
Update an existing tag's name
Inputs: name (required), tagId (required).
Upload a file (receipt image/PDF) for a voucher
Inputs: fileName (required), voucherId (required), base64Content (required), creditDebit.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 34 tools
Each tool targets a distinct resource-action pair (e.g., create_tag vs. list_tags, send_invoice_by_email vs. mark_invoice_as_sent). Even with 34 tools, there is no ambiguity; every tool has a unique purpose and domain.
All tools follow a consistent verb_noun pattern in snake_case (e.g., create_tag, get_invoice, list_transactions). Prepositional phrases are used uniformly (e.g., send_invoice_by_email, get_check_account_balance), and there is no mixing of conventions.
34 tools is on the higher end but appropriate for a comprehensive accounting server covering tags, invoices, vouchers, contacts, check accounts, transactions, and parts. Each tool serves a specific function; no tool appears redundant.
Significant gaps exist: missing create_invoice, update_invoice, create_voucher, update_voucher, and update/delete for check accounts and transactions. Core CRUD operations for invoices and vouchers are absent, which will hinder common workflows.
sevdesk MCP server for ChatGPT, Claude and any AI agent: create invoice, send invoice, upload receipt, book voucher and list open invoices in your own sevdesk account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to sevdesk yourself; Cotlet does not store your password and you need no sevdesk API key. About the official sevdesk API: sevdesk has a REST API (checked 14 Oct 2026). It covers almost everything the web app does, but only on the Buchhaltung Pro plan, in Germany, on system version 2.0. Setup and FAQ: https://cotlet.dev/integrations/sevdesk-api-mcp-server
Connect Claude to Dutch accounting software: e-Boekhouden invoices, contacts and ledgers.
Query your books, company data, business health, and ship invoices from your AI assistant.
Connect ChatGPT and Claude to Fortnox: invoices, customers, reports. Every write needs your OK.
