Skip to content
MCP server

sevDesk

Unofficial sevDesk accounting server that is read-only until you allow writes

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

Add 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#tokenRequired
  • SEVDESK_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#tokenRequired
  • SEVDESK_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

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  4. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  5. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 4 tools
    • Remote
    • Free
    • Finance and payments
  6. TribuJus

    MCP server

    Read-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • Legal and government