# Sevdesk MCP

> Sevdesk MCP is a free MCP server for finance and payments. sevDesk bookkeeping from your assistant: all API endpoints, guarded writes and VAT audits. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, self-hosted, macOS, Linux, Windows
- **Repository:** https://github.com/joosthel/sevdesk-mcp
- **MCP Registry name:** io.github.joosthel/sevdesk-mcp
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add sevdesk-mcp --env SEVDESK_API_TOKEN='<SEVDESK_API_TOKEN>' -- npx -y sevdesk-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "sevdesk-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "sevdesk-mcp"
      ],
      "env": {
        "SEVDESK_API_TOKEN": "<SEVDESK_API_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "sevdesk-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "sevdesk-mcp"
      ],
      "env": {
        "SEVDESK_API_TOKEN": "<SEVDESK_API_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "sevdesk-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "sevdesk-mcp"
      ],
      "env": {
        "SEVDESK_API_TOKEN": "<SEVDESK_API_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "sevdesk-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "sevdesk-mcp"
      ],
      "env": {
        "SEVDESK_API_TOKEN": "<SEVDESK_API_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "sevdesk-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "sevdesk-mcp"
      ],
      "env": {
        "SEVDESK_API_TOKEN": "<SEVDESK_API_TOKEN>"
      }
    }
  }
}
```

## Tools

- `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

## 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.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Crypto Feeds](https://ai-powered.com/mcp/crypto-feeds): Crypto Feeds is a freemium MCP server for finance and payments.
- [Crypto Fng](https://ai-powered.com/mcp/crypto-fng): Crypto Fng is a freemium MCP server for finance and payments.
- [Creditcard](https://ai-powered.com/mcp/creditcard): Creditcard is a freemium MCP server for finance and payments.
- [Zovo LEI Lookup](https://ai-powered.com/mcp/zovo-lei-lookup): Zovo LEI Lookup is an MCP server for finance and payments.
- [Recurly](https://ai-powered.com/mcp/recurly): Recurly is a freemium MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/sevdesk-mcp
