# sevDesk

> sevDesk is a free MCP server for finance and payments. Unofficial sevDesk accounting server that is read-only until you allow writes. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, macOS, Windows, Linux
- **Website:** https://sevdeskmcp.lanfermann.dev
- **Repository:** https://github.com/jaylann/mcp-server-sevdesk
- **MCP Registry name:** io.github.jaylann/mcp-server-sevdesk
- **Categories:** finance and payments
- **Listing updated:** 2026-11-14

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

- `sevdesk_account_info`: Describes how the connected sevDesk account is set up.

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

- [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.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

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