Skip to content
MCP server

Sevdesk MCP

sevDesk bookkeeping from your assistant: all API endpoints, guarded writes and VAT audits

Runs locallyStatus and history
Install
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-mcp

Add 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)Required
  • SEVDESK_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.

How AIPoweredBot checks servers