mcp-server-sevdesk
v1.6.0
Published
Safety-first MCP server for the sevDesk accounting API: invoices, receipts, banking and reports with tiered permissions and human confirmation. Unofficial.
Maintainers
Readme
mcp-server-sevdesk
A safety-first Model Context Protocol server for the sevDesk accounting API. It lets AI assistants (Claude, Cursor, VS Code, Codex, …) read and work with your invoices, receipts, bank transactions and reports, with permissions you control and a human confirmation step for anything that is legally binding.
Documentation · Quick start · Tool reference · Releases · 🇩🇪 Deutsch
[!NOTE] This is an unofficial community project. It is not affiliated with, endorsed by or supported by sevdesk GmbH. "sevDesk" is a trademark of its owner.
Highlights
A sevDesk API token has full access to the whole account, and sevDesk has no sandbox. This server is built around that fact:
- Read-only by default. Writes are opt-in tiers (
write→commit→external); tools above your tier are never shown to the model. - Real human confirmation. Finalizing, booking, cancelling or emailing asks you, in your client or on an approval page in your browser. The model cannot approve itself.
- No surprise side effects. Previewing a PDF never marks an invoice as sent, writes are never retried, and every write is read back and can go to a local audit log.
- Correct for sevDesk Update 2.0. Tax rules and booking accounts are validated before anything is sent.
- Compact, typed output. Aggregations run on the server, so the model doesn't page through hundreds of records; the fields are described in the tool reference.
Quick start
You need a sevDesk plan with API access (Buchhaltung Pro; the free trial includes it), the API token of a sevDesk user (Settings → Users → API token; ideally a user just for the assistant) and, except for the Claude Desktop extension, Node.js 22.12 or later.
Claude Desktop: download
mcp-server-sevdesk-<version>.mcpbfrom the latest release, open it and paste your token (details).Claude Code: store the token in the OS keychain, then add the server, or install the plugin:
npx -y mcp-server-sevdesk token set work claude mcp add --env SEVDESK_API_TOKEN_KEYCHAIN=work --scope user sevdesk -- npx -y mcp-server-sevdeskCursor, VS Code, Windsurf, Codex, Zed and others start
npx -y mcp-server-sevdeskwith the token in the environment; Clients has the exact file for each.claude.ai and the Claude mobile apps connect to a server you host in remote mode.
Then ask "What is my sevDesk account set up like?". The server starts read-only; the quickstart guide continues with enabling writes, a dry run first, and keeping the token safe.
What it can do
75 tools across 10 toolsets. The 38 read tools fill the first column; with the write tiers enabled, 37 more tools create and change data.
| Area | Read | Write (write, commit, external) |
| ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Account | Account overview and reference data: tax rules, booking accounts, units, countries | |
| Invoices, credit notes, orders | List and get; PDFs and e-invoice XML as MCP resources; an e-invoice readiness check for outgoing invoices | Drafts, including orders (Angebot, Auftragsbestätigung, Lieferschein), invoices from orders, credit notes from invoices and dunning reminders (Mahnungen). Finalize, book payments, enshrine (festschreiben, irreversible), reset, cancel (Storno). Send by email |
| Vouchers (Belege) | List and get; parse received e-invoices locally (XRechnung UBL/CII, ZUGFeRD/Factur-X) | Drafts with the receipt file attached, imports from an e-invoice. Finalize, book payments, enshrine, reset, delete drafts |
| Banking | Accounts and transactions; reconciliation suggestions from the amount, the invoice number in the purpose, the counterparty and splits | Book a transaction against one or more documents (split payments, guarded against over-booking), mark it as private (Privatentnahme/-einlage), undo an assignment |
| Reports | Summaries, receivables and payables aging, cash position, changes since a date, a VAT summary (UStVA boxes, ZM, OSS) and an EÜR-style profit and loss | The DATEV export (Buchungsstapel ZIP, never enshrined) |
| Contacts and parts | Search and get, parts with their stock (Lagerbestand) | Create and update, including a part's stock and stockEnabled |
| Advanced (off by default) | sevdesk_api_get: a read-only GET of any sevDesk endpoint no other tool covers, such as text templates. It refuses everything that could change data, return files or start jobs | |
The VAT summary is clearly marked as an estimate (accrual or cash basis). Every write tool accepts
dryRun: true and then only returns exactly what it would do. Voucher drafts can be in a foreign
currency, with an exchange rate or a rate date; such drafts cannot be finalized through the server
(Receipts). The full generated reference is
docs/tools.md.
Prompts
Ready-made workflows as MCP prompts. Clients list them next to the tools; in Claude Code they are
slash commands such as /mcp__sevdesk__month_end_close.
| Prompt | What it does | Arguments |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
| month_end_close | Monatsabschluss: changes, unbooked transactions, drafts, receivables and payables, VAT pre-check, profit, DATEV hand-over | month (YYYY-MM, default: previous month) |
| receipt_intake | Beleg erfassen, E-Rechnung importieren: duplicate check, booking account and tax rule, voucher draft, finalize, payment | file (optional) |
| dunning_run | Mahnlauf: overdue invoices, unbooked incoming payments, reminder drafts | contact (name/id), minDaysOverdue (0–3650 days); both optional |
| vat_precheck | UStVA-Vorprüfung: unbooked transactions and drafts, VAT summary (Kennzahlen), ZM | period (YYYY-MM or YYYY-Qn) |
| bank_reconciliation | Kontoabgleich: suggestions, bookings, private transactions, corrections | checkAccount (name/id), month (YYYY-MM); both optional |
A prompt appears only when the tools it needs are enabled; steps that need a disabled tier, toolset or folder are listed with the setting that enables them. Prompts only produce text for the assistant: every change still goes through the tools, with a dry run first and your confirmation for binding steps. Not tax advice.
Permissions and configuration
The server only reads until you enable more with SEVDESK_ALLOW: write (drafts, contacts,
parts, DATEV export), commit (finalize, book, cancel, enshrine) and external (send by email).
Before anything binding is sent, the server shows you exactly what will happen (amounts,
recipients, the full email text) and waits for your approval; if the record changes before you
approve, it asks again (Permissions;
which clients can ask in the chat). All settings are
environment variables in your client's server configuration; only a token is required, and
everything else defaults to the safest option (Configuration).
Remote mode
With --http the server runs as a web service you host yourself (there is no hosted instance), for
claude.ai and the Claude apps, an editor on another machine, or a small team. It refuses to start
without authentication: OAuth, where each user connects through a consent page and the server
stores no sevDesk token, or a shared bearer secret for one account. Remote mode
has the quick starts, deployment, configuration and operations.
Claude Code plugin
The repository is also a Claude Code plugin marketplace: the sevdesk plugin starts this server
and adds a bookkeeping skill for German tax rules, SKR03/SKR04, GoBD and e-invoices. Installing
and configuring it: The plugin.
Documentation
- Start: Quickstart · Troubleshooting · FAQ · Glossary
- Clients: Overview · Claude Desktop · Claude Code · claude.ai · Cursor · VS Code · Windsurf · Codex · Zed
- Guides: Invoices · Receipts · Reports
- Reference: Permissions · Audit log · Configuration · Profiles · Tools · Compatibility
- Remote mode: Overview · Deployment · Configuration · Approvals · Files · Operations · Troubleshooting
- Security: Policy · Confirmation · Local · Remote · Supply chain · Privacy
- Project: Architecture · Safety · Transports · Build and test · ADRs · Contributing · Changes · Testing · Recording session
What's next in 1.x: sending letters by post and sevDesk accounts in Austria. The changelog lists every release.
Contributing
Contributions are welcome. Start with Contributing, and please report security issues privately as described in the Security policy.
License
MIT © 2026 Justin Lanfermann
