sevDesk
Unofficial sevDesk accounting server that is read-only until you allow writes
- Pricing
- Free
- Platforms
- CLI, macOS, Windows
- Runs
- Locally
- Version
- 1.6.0
- Listing updated
- 3 days ago
About sevDesk
sevDesk is a free MCP server for finance and payments. It runs locally on your machine and is started by your AI client.
A sevDesk API token has full access to an account and sevDesk has no sandbox, so this server is built around permission tiers. It starts read-only. Writes are opt-in tiers called write, commit and external, and tools above your tier are never registered, so the model does not see them. Finalising, booking, cancelling or emailing asks you in the client or on a local approval page, and the model cannot approve itself. If the record changes while waiting, it asks again.
Before sending anything it validates status, amounts, tax rules and booking accounts against sevDesk Update 2.0, and a dry-run mode shows previews only. Writes are never retried, every result is read back, and an optional JSON Lines audit log keeps a redacted record on your machine. Aggregations run on the server so the model does not page through hundreds of records.
The README counts 75 tools in 10 toolsets, 38 of them read tools. It handles invoices, receipts, bank transactions and reports, reads XRechnung and ZUGFeRD files locally, and can save PDFs, e-invoice XML, CSV and DATEV exports to a folder you name. It needs a sevDesk plan with API access and Node.js 22.12 or later (not for the Claude Desktop extension). It is an unofficial community project, not supported by sevdesk GmbH.
Install
Run in a terminal
claude mcp add mcp-server-sevdesk --env SEVDESK_API_TOKEN='<SEVDESK_API_TOKEN>' -- npx -y mcp-server-sevdeskAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp-server-sevdesk": {
"command": "npx",
"args": [
"-y",
"mcp-server-sevdesk"
],
"env": {
"SEVDESK_API_TOKEN": "<SEVDESK_API_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server-sevdesk": {
"command": "npx",
"args": [
"-y",
"mcp-server-sevdesk"
],
"env": {
"SEVDESK_API_TOKEN": "<SEVDESK_API_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp-server-sevdesk": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-server-sevdesk"
],
"env": {
"SEVDESK_API_TOKEN": "<SEVDESK_API_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-server-sevdesk": {
"command": "npx",
"args": [
"-y",
"mcp-server-sevdesk"
],
"env": {
"SEVDESK_API_TOKEN": "<SEVDESK_API_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp-server-sevdesk": {
"command": "npx",
"args": [
"-y",
"mcp-server-sevdesk"
],
"env": {
"SEVDESK_API_TOKEN": "<SEVDESK_API_TOKEN>"
}
}
}
}Configuration
SEVDESK_API_TOKENsevDesk API token (Settings > Users > API token). It has full access to the account; ideally create it for a dedicated user. To keep it out of the client configuration, set up the server by hand with SEVDESK_API_TOKEN_KEYCHAIN (OS keychain) or SEVDESK_API_TOKEN_FILE instead: https://sevdeskmcp.lanfermann.dev/docs/en/configuration#tokenRequiredSEVDESK_ALLOWComma-separated permission tiers to enable: read, write, commit, external, or all. Tools above the allowed tiers are not registered. read is always on.SEVDESK_READ_ONLYSet to true to allow only read tools, whatever SEVDESK_ALLOW says.SEVDESK_DRY_RUNSet to true to make write tools only return a preview of what they would do, without sending anything.SEVDESK_CONFIRMHow a human confirms commit and external actions: elicit (in the client), browser (local approval page) or off (also needs SEVDESK_I_UNDERSTAND_NO_CONFIRM=1).SEVDESK_AUDIT_LOGPath of a local JSON Lines file that records every write the server makes (redacted). Unset: no audit log.SEVDESK_TOOLSETSComma-separated toolsets to load, e.g. invoices,vouchers,banking. Unset loads all except advanced; all adds advanced.SEVDESK_FILE_DIRSAbsolute folders (separated like PATH) that receipts and e-invoices may be read from, for voucher uploads and e-invoice import. Unset: no local file is read.SEVDESK_OUTPUT_DIRFolder where PDFs, e-invoice XML, CSV and DATEV exports may be saved. Unset: the file-saving tools are not offered.SEVDESK_API_TOKENsevDesk API token (Settings > Users > API token). It has full access to the account; ideally create it for a dedicated user. To keep it out of the client configuration, run the image by hand with SEVDESK_API_TOKEN_FILE and a mounted secret file instead: https://sevdeskmcp.lanfermann.dev/docs/en/configuration#tokenRequiredSEVDESK_ALLOWComma-separated permission tiers to enable: read, write, commit, external, or all. Tools above the allowed tiers are not registered. read is always on.SEVDESK_READ_ONLYSet to true to allow only read tools, whatever SEVDESK_ALLOW says.SEVDESK_DRY_RUNSet to true to make write tools only return a preview of what they would do, without sending anything.SEVDESK_CONFIRMHow a human confirms commit and external actions: elicit (in the client) or off (also needs SEVDESK_I_UNDERSTAND_NO_CONFIRM=1). The browser mode's local approval page is not reachable from outside the container.SEVDESK_AUDIT_LOGPath inside the container (on a mounted, writable volume) of a JSON Lines file that records every write the server makes (redacted). Unset: no audit log.SEVDESK_TOOLSETSComma-separated toolsets to load, e.g. invoices,vouchers,banking. Unset loads all except advanced; all adds advanced.SEVDESK_FILE_DIRSAbsolute folders inside the container (separated by colons) that receipts and e-invoices may be read from; mount them into the container. Unset: no local file is read.SEVDESK_OUTPUT_DIRFolder inside the container (mount it, writable) where PDFs, e-invoice XML, CSV and DATEV exports may be saved. Unset: the file-saving tools are not offered.
Tools this server provides (1)
Taken from the project documentation; the running server may differ.
- sevdesk_account_info
- Describes how the connected sevDesk account is set up.
What it does
- Permission tiers
- Read-only by default; write, commit and external are opt-in.
- Human confirmation
- Booking and sending need your approval, not the model's.
- Dry-run previews
- Shows what a write would do without sending it.
- Pre-send validation
- Checks tax rules, amounts and booking accounts first.
- Audit log
- Optional local log of every write, redacted.
- Local e-invoice reading
- Reads XRechnung and ZUGFeRD files from allowed folders.
Good for
- Review open invoices and receipts
- Match bank transactions to documents
- Prepare a month-end summary
- Draft and send an invoice after approval
- Export data for DATEV
Pricing
Free
Free server; requires a sevDesk plan with API access
Prices change. Check sevdeskmcp.lanfermann.dev before you buy.
sevDesk FAQ
Can the assistant book or email without me?
No. Binding actions ask you for confirmation and the model cannot approve itself.
What do I need?
A sevDesk plan with API access, an API token and Node.js 22.12 or later.
Is it official?
No, it is an unofficial community project.
How do I keep the token out of config files?
Use SEVDESK_API_TOKEN_KEYCHAIN or SEVDESK_API_TOKEN_FILE.
Is sevDesk free?
Yes. sevDesk is free to use.
How do I add sevDesk to Claude Code?
Run this command in your terminal: claude mcp add mcp-server-sevdesk --env SEVDESK_API_TOKEN='<SEVDESK_API_TOKEN>' -- npx -y mcp-server-sevdesk
What are the best alternatives to sevDesk?
The closest alternatives to sevDesk are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.
Alternatives to sevDesk

Solana MCP by Vybe
MCP serverRemote MCP server exposing the Vybe Solana API to AI clients and code editors
- 44 tools
- Remote
- 2.8K GitHub stars
- Finance and payments

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments
Budget Tracker
MCP serverLocal MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling
- 14 tools
- Remote
- Freemium
- 2 GitHub stars
- Finance and payments

Quantivex Research
MCP serverStock scores, what a price assumes, earnings quality and quiet profit revisions
- 11 tools
- Remote
- Free
- Finance and payments

Provyan
MCP serverBacktested crypto signal results on 94 coins, with luck odds and sources
- 4 tools
- Remote
- Free
- Finance and payments
TribuJus
MCP serverRead-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking
Not checked yet- 5 tools
- Remote
- Open source
- Legal and government