Sevdesk MCP
sevDesk bookkeeping from your assistant: all API endpoints, guarded writes and VAT audits
- Pricing
- Free
- Platforms
- CLI, self-hosted, macOS
- Runs
- Locally
- Version
- 0.6.0
- Listing updated
- today
Similar MCP servers
About Sevdesk MCP
Sevdesk MCP is a free MCP server for finance and payments. It runs locally on your machine and is started by your AI client.
This server connects an assistant to a sevDesk account with 24 tools that reach all 151 API operations. Rather than registering that many tools, it ships a searchable catalogue generated from sevDesk's OpenAPI document, with sevdesk_list_operations, sevdesk_describe_operation and sevdesk_call. Everyday tools list vouchers, invoices, contacts and transactions, upload receipts, create vouchers, and create invoices, which are always drafts, so nothing reaches a customer unreviewed.
Its distinguishing part is a bookkeeping audit layer that knows what a wrong booking looks like. sevdesk_audit_vat flags cases such as a foreign supplier booked as domestic 0 % instead of Reverse Charge under §13b, tax rules the booking account does not allow, and sums that do not add up. Other tools report the §13b tax base for a period, find duplicates, detect missing subscription months, reconcile bank transactions against vouchers, diff a local receipt folder, and age open invoices.
The API token has no scopes and can do whatever your login can, so the README advises starting with SEVDESK_READ_ONLY=true. Write tools accept a dryRun option, and requests are paced client-side at four per second by default. It needs Node.js 22 or later and a sevDesk account, was validated by its author against a real account on bookkeeping system 2.0, and ships an optional Agent Skill with month-end workflows.
Install
Run in a terminal
claude mcp add sevdesk-mcp --env SEVDESK_API_TOKEN='<SEVDESK_API_TOKEN>' -- npx -y sevdesk-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"sevdesk-mcp": {
"command": "npx",
"args": [
"-y",
"sevdesk-mcp"
],
"env": {
"SEVDESK_API_TOKEN": "<SEVDESK_API_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"sevdesk-mcp": {
"command": "npx",
"args": [
"-y",
"sevdesk-mcp"
],
"env": {
"SEVDESK_API_TOKEN": "<SEVDESK_API_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"sevdesk-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"sevdesk-mcp"
],
"env": {
"SEVDESK_API_TOKEN": "<SEVDESK_API_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"sevdesk-mcp": {
"command": "npx",
"args": [
"-y",
"sevdesk-mcp"
],
"env": {
"SEVDESK_API_TOKEN": "<SEVDESK_API_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"sevdesk-mcp": {
"command": "npx",
"args": [
"-y",
"sevdesk-mcp"
],
"env": {
"SEVDESK_API_TOKEN": "<SEVDESK_API_TOKEN>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
SEVDESK_API_TOKENsevDesk API token (Settings → Users → your user → API)RequiredSEVDESK_READ_ONLYStart in read-only mode (recommended: true)SEVDESK_ALLOW_BOOKINGAllow booking and removing payments on vouchers, invoices and credit notes (default false)SEVDESK_RATE_LIMITClient-side request pacing in requests/second (default 4; 0 disables)
Tools this server provides (24)
Taken from the project documentation; the running server may differ.
- sevdesk_ping
- Check connection, bookkeeping version and mode
- sevdesk_audit_vat
- Flag VAT and booking mistakes
- sevdesk_reverse_charge_report
- Total the §13b tax base for a period
- sevdesk_find_duplicates
- Find duplicate vouchers
- sevdesk_subscription_gaps
- Report missing months in recurring supplier bookings
- sevdesk_diff_receipt_folder
- Diff a receipt folder against booked vouchers
- sevdesk_reconcile_transactions
- Match bank transactions to vouchers
- sevdesk_invoice_aging
- Bucket open invoices by days overdue
- sevdesk_summarize
- Aggregate invoices or vouchers server-side
- sevdesk_list_vouchers
- List vouchers
- sevdesk_get_voucher
- Get a voucher
- sevdesk_list_invoices
- List invoices
- sevdesk_list_contacts
- List contacts
- sevdesk_list_transactions
- List bank transactions
- sevdesk_receipt_guidance
- Show accepted account, tax rule and rate combinations
- sevdesk_upload_voucher_file
- Upload a receipt file
- sevdesk_create_voucher
- Create a voucher
- sevdesk_set_tax_rule
- Rebook a draft voucher onto another tax rule
- sevdesk_create_invoice
- Create a draft invoice
- sevdesk_get_invoice_pdf
- Save an invoice's rendered PDF
- sevdesk_mark_invoice_sent
- Mark an invoice as sent
- sevdesk_list_operations
- Search the API operation catalogue
- sevdesk_describe_operation
- Show an operation's signature
- sevdesk_call
- Call any sevDesk API operation
What it does
- Full API reach
- A searchable catalogue covers all 151 sevDesk operations.
- VAT audit
- Finds reverse-charge mis-bookings and tax-rule mismatches.
- Bank reconciliation
- Matches transactions against vouchers by amount and date.
- Safe writes
- Read-only mode, dry runs and draft-only invoices.
- Invoice aging
- Buckets open invoices by days overdue.
- Server-side summaries
- Aggregates revenue or expenses without large token cost.
Good for
- Run a VAT audit and explain high-severity findings
- Total the §13b reverse-charge base for a quarter
- Find bank payments that have no receipt
- Chase overdue invoices by age
Pricing
Free
Free server; requires a sevDesk account
Sevdesk MCP FAQ
How do I keep it safe?
Set SEVDESK_READ_ONLY to true; write tools also support dryRun, and invoices are always created as drafts.
Does the token have limited scopes?
No. A sevDesk API token has no scopes and can do everything your login can.
What do I need?
Node.js 22 or later, a sevDesk account and an API token from Settings, Users, API.
Does it cover every endpoint?
Yes, through the generic catalogue tools that reach all 151 operations.
Is Sevdesk MCP free?
Yes. Sevdesk MCP is free to use.
How do I add Sevdesk MCP to Claude Code?
Run this command in your terminal: claude mcp add sevdesk-mcp --env SEVDESK_API_TOKEN='<SEVDESK_API_TOKEN>' -- npx -y sevdesk-mcp
What are the best alternatives to Sevdesk MCP?
The closest alternatives to Sevdesk MCP are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Crypto Feeds and Crypto Fng.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

