sevdesk-mcp
A complete MCP server for sevDesk that exposes all 154 API operations through 30 tools, with guarded writes and a built-in bookkeeping audit layer.
Audit VAT treatment — flag reverse-charge mis-bookings (foreign suppliers booked as domestic 0 % instead of §13b), wrong-side rules, disallowed tax rules, contradictory rates, and sums that don't add up (
sevdesk_audit_vat).Report §13b tax base — split into nets-to-zero (rules 12/14), actually payable (13) and own revenue (5) (
sevdesk_reverse_charge_report).Detect duplicates and stuck drafts — repeated document numbers, same supplier + amount within N days, vouchers left in Entwurf (
sevdesk_find_duplicates).Find subscription gaps — monthly cadences per supplier with missing months (
sevdesk_subscription_gaps).Diff a receipt folder against booked vouchers in both directions (
sevdesk_diff_receipt_folder).Reconcile bank transactions with vouchers — payments without receipts, vouchers without payments (
sevdesk_reconcile_transactions).Age receivables — overdue invoices bucketed by days, partial remainders, drafts never sent (
sevdesk_invoice_aging).Read and summarize vouchers, invoices, contacts and bank transactions, with server-side aggregation for totals (
sevdesk_summarize).Get booking-account guidance — which DATEV/SKR accounts exist and which tax rules and rates each allows (
sevdesk_receipt_guidance).Create drafts safely — vouchers (default status 50) and invoices (always drafts), with optional receipt file upload (local path or inline base64).
Correct drafts — change date, number, supplier, tax rule and positions; optionally finalize to open with
SEVDESK_ALLOW_BOOKING(sevdesk_update_draft_voucher).Rebook tax rules with guardrails and read-back verification (
sevdesk_set_tax_rule).Export invoice PDFs without changing send state, and mark invoices as sent (no email tool by design).
Ledger cleanup — delete draft vouchers, mark transactions private, link transactions to book payments (booking tools gated behind
SEVDESK_ALLOW_BOOKING).Reach every endpoint via a searchable catalogue:
sevdesk_list_operations,sevdesk_describe_operation,sevdesk_call.Write safety — read-only mode enforced three times, per-call and global
dryRun, drafts by default, booking operations opt-in, no replay of writes on ambiguous failures.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@sevdesk-mcp audit my vouchers from last month for reverse charge issues"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
sevdesk-mcp
English · Deutsch
The complete MCP server for sevDesk: every API endpoint, guarded writes, and a built-in bookkeeping audit layer.
Connect Claude (or any MCP client) to your sevDesk account: list and create vouchers and invoices, reconcile bank transactions, reach all 154 API operations — and run audits that know what a wrong booking looks like: a foreign supplier booked as domestic 0 % instead of Reverse Charge §13b, a tax rule the booking account doesn't allow, a payment with no receipt behind it.
Status: v0.6.0. Live-validated against a real sevDesk account (bookkeeping system 2.0) — where the audit found exactly the class of mis-booking it was built for. See CHANGELOG.md.
Quick start
You need: Node.js ≥ 22, a sevDesk account, and an MCP client (Claude Code, Claude Desktop, or any other).
1. Get your API token
In sevDesk: Settings → Users → your user → API. The token is a 32-character hex string.
⚠️ A sevDesk API token has no scopes — it can do everything your login can. Treat it like your password, and start in read-only mode.
2. Connect your MCP client
Claude Code — one command, then put your real token into the config it writes (~/.claude.json):
claude mcp add --scope user sevdesk \
--env SEVDESK_API_TOKEN=REPLACE_ME \
--env SEVDESK_READ_ONLY=true \
-- npx -y sevdesk-mcpClaude Desktop — add to claude_desktop_config.json (Settings → Developer → Edit Config):
{
"mcpServers": {
"sevdesk": {
"command": "npx",
"args": ["-y", "sevdesk-mcp"],
"env": {
"SEVDESK_API_TOKEN": "your-token",
"SEVDESK_READ_ONLY": "true"
}
}
}
}Any other MCP client works the same way: stdio transport, npx -y sevdesk-mcp (or node dist/index.js from a clone), config via environment variables. To run from source instead: git clone https://github.com/joosthel/sevdesk-mcp && cd sevdesk-mcp && npm install && npm run build.
3. First run
Restart your client and ask it to run sevdesk_ping. You should see ok: true, your bookkeeping system version (2.0 = taxRule, 1.0 = legacy taxType) and the mode (READ-ONLY). Then start asking:
"Run a VAT audit for this year and explain every high-severity finding."
"Are my US software subscriptions booked as reverse charge? What's my §13b base this quarter?"
"Which bank payments have no receipt yet?"
"Draft an invoice for contact 1009: 3 days of consulting at 800 €." (needs write mode)
"Which booking accounts allow taxRule 12?"
"Call the sevDesk API: get the last 10 orders." — the generic catalogue covers everything the curated tools don't.
What a finding looks like:
{
"severity": "high",
"code": "zero_rate_booked_as_domestic",
"voucher": "2026-06-24 · Acme Cloud, Inc. · 88.03 EUR · #INV-2043",
"detail": "Booked as \"Vorsteuerabziehbare Aufwendungen\" (taxRule 9) but every position carries 0 % VAT, and the supplier's contact is registered in \"us\".",
"suggestion": "If this is a service from a supplier established abroad, it is Reverse Charge: taxRule 12 (§13b Abs. 2, with input-tax deduction) …"
}4. Enabling writes (optional, later)
Once you trust the setup, set SEVDESK_READ_ONLY to "false" and restart the client. Every write tool accepts dryRun (and honors the global SEVDESK_DRY_RUN) — it shows exactly what would be sent without sending it. See Write safety.
Related MCP server: datev-mcp-server
Tools
30 tools cover all 154 API operations (26 without SEVDESK_ALLOW_BOOKING).
Audit
Tool | What it does |
| Flags reverse-charge mis-bookings, rules from the wrong side of the books, tax rules the booking account doesn't allow, rates that contradict the tax rule, sums that don't add up, suppliers booked inconsistently. Uses the supplier contact's country where available |
| Totals the §13b tax base for a period — split into nets-to-zero (rule 12/14), actually payable (rule 13) and own revenue (rule 5) |
| Repeated document numbers, same supplier + amount within N days, vouchers stuck in Entwurf |
| Detects monthly cadences per supplier and reports the missing months |
| Diffs a local folder of receipt PDFs against booked vouchers, both directions (requires |
| Matches bank transactions against vouchers by amount and date proximity: payments without a receipt, vouchers without a payment |
| Who owes you money and for how long: open invoices bucketed by days overdue, partially paid remainders, drafts never sent |
Everyday
sevdesk_ping · sevdesk_summarize · sevdesk_list_vouchers · sevdesk_get_voucher · sevdesk_list_invoices · sevdesk_list_contacts · sevdesk_list_transactions · sevdesk_receipt_guidance · sevdesk_upload_voucher_file · sevdesk_create_voucher · sevdesk_set_tax_rule · sevdesk_create_invoice · sevdesk_get_invoice_pdf · sevdesk_mark_invoice_sent
Booking (only with SEVDESK_ALLOW_BOOKING=true): sevdesk_link_transaction books vouchers against an existing bank transaction, the same as assigning receipts in the sevDesk UI; a split payment goes in one call. sevdesk_reset_voucher_to_open removes all payments from a voucher again. sevdesk_delete_voucher and sevdesk_set_transaction_private (see Ledger cleanup) are booking tools too, and sevdesk_update_draft_voucher only accepts finalize with the flag. sevdesk_create_voucher takes status 100 (open), 1000 (paid), payDate and paidAmount only with the flag; it creates drafts otherwise. With the flag, sevdesk_call can also book invoice and credit-note payments (bookInvoice, bookCreditNote); without it, those and the other booking operations are refused.
Highlights: sevdesk_summarize aggregates invoices or vouchers server-side — counts and net/tax/gross sums grouped by month, status or contact — so questions like "revenue in Q2" or "expenses by supplier" cost a few hundred tokens however large the ledger is. sevdesk_receipt_guidance answers "which booking account / tax rule / rate combinations does sevDesk actually accept" from sevDesk's own validation table. sevdesk_set_tax_rule rebooks a draft voucher onto a different VAT rule with guardrails. sevdesk_create_invoice always creates drafts — nothing reaches a customer without review. sevdesk_get_invoice_pdf saves the rendered PDF without touching the invoice's send state.
Ledger cleanup
Tool | What it does |
| Deletes a draft voucher (status 50) without payments, e.g. a duplicate; returns what was deleted. Needs |
| Marks an open bank transaction (status 100) as private (300); sevDesk books it as a private withdrawal or deposit. Needs |
| Uploads a receipt sent inline as base64 (PDF/PNG/JPG or XML e-invoice, checked by content, max 10 MB) — for hosted clients without filesystem access |
| Corrects a draft: date, document number, supplier, tax rule, positions (amount, rate, booking account); |
All four refuse enshrined objects, accept dryRun, and read the object back to verify the change. They exist so that routine cleanup does not need the generic sevdesk_call, which knows nothing about an object's state. To mark a voucher paid, link it to its bank transaction with sevdesk_link_transaction; it takes an optional type per voucher (CB for a Skonto, MTC for bank charges, O for other reductions) and warns when the bank text does not name the supplier.
Full coverage
sevdesk_list_operations · sevdesk_describe_operation · sevdesk_call
Rather than registering 154 tools and swamping the client's tool list, the server ships a searchable catalogue generated from sevDesk's OpenAPI document. Search for what you need, read its signature, call it. Every endpoint is reachable.
Common workflows
The tools compose — these are everyday bookkeeping jobs, each a single prompt:
Month-end close: "Do a month-end check for June: pending drafts, bank payments without receipts, vouchers without payments, VAT findings, sums that don't add up."
Chasing money: "Who owes me money? Show overdue invoices by age, and tell me which ones were never even marked as sent."
Receipt discipline: "Compare my receipts folder with sevDesk and list what's missing on either side." (needs
SEVDESK_RECEIPT_DIRS)Recurring costs: "Which subscriptions stopped appearing, and which suppliers am I booking inconsistently?"
Before the VAT return: "Run the VAT audit and the §13b report for the quarter and summarize what my Steuerberater should know."
Anything else: "Call the sevDesk API: …" — orders, credit notes, exports, parts and every other endpoint are reachable through the catalogue.
Agent Skill (optional)
The package ships an Agent Skill with these workflows spelled out — monthly close order, receipt triage, §13b investigation, audit-finding interpretation — so agents load the know-how on demand instead of rediscovering it each session. For Claude Code, copy it next to your project:
cp -r node_modules/sevdesk-mcp/skills/sevdesk-bookkeeping .claude/skills/(or copy from a clone of this repo). Clients without skill support lose
nothing: the server's own instructions and tool descriptions carry the
essentials.
Configuration
Variable | Default | Purpose |
| (required) | Your sevDesk API token |
|
| Boolean ( |
|
| Boolean, same accepted values. Show what a write would send, without sending it |
| (unset — file tools disabled) | Allowlist of absolute directories the receipt file tools may read and write, separated by the platform path separator ( |
|
| Override the API host. Must be |
|
| Per-request timeout (whole number > 0) |
|
| Whole number >= 0; |
|
| Client-side pacing in requests/second (token bucket), so bursty audit fan-outs don't collide with sevDesk's throttle. |
|
| Boolean, same accepted values. List the booking tools ( |
|
| Boolean, same accepted values. Log |
Set these in the env block of your MCP client — that is the supported path and the
one the client controls. For runs outside a client (npm run dev, node dist/index.js
from a clone), copy .env.example to .env in the package root and the server reads it
at startup. The file is read from the package root, never the working directory, and
real environment variables always win over it, so a client's env block can never be
shadowed by a stale .env. .env is gitignored.
The threat model, guarantees and vulnerability reporting are documented in SECURITY.md.
Privacy Policy
Everything runs locally: your token and accounting data flow only between your MCP client and the sevDesk API — no storage, no telemetry, no third parties. Full policy: PRIVACY.md.
Write safety
Read-only mode is enforced three times: write tools are hidden from the tool list, the dispatcher refuses them, and the HTTP client refuses every mutating request independently. sevdesk_call treats GETs that change state (sendByWithRender, a truthy enshrine* flag, preventSendBy turned off) as writes. With writes enabled:
Every write tool accepts a per-call
dryRunand honors the globalSEVDESK_DRY_RUN.sevdesk_create_voucherandsevdesk_create_invoicedefault to drafts — nothing is booked or sent silently.Booking payments is a separate opt-in: without
SEVDESK_ALLOW_BOOKING=truethe booking tools are hidden and refused, andsevdesk_callrefuses the ten booking operations (bookVoucher,bookInvoice,bookCreditNote, their*ResetToOpenand*ResetToDraft,createPrivateTransactionRule) and writes whose body books:updateCheckAccountTransactionwith astatus,updateVoucherwith astatusother than 50,paidAmountorpayDate,voucherFactorySaveVoucherwith the same onvoucher,createTransactionwith a status other than 100, and any write that carriespaidAmount,payDate, or a transfer link anywhere in the body or query, or sets an invoice, credit note or voucher to 750 (partly paid) or 1000 (paid), dry runs included.sevdesk_create_voucherrefuses status 100/1000,payDateandpaidAmount, andsevdesk_update_draft_voucherrefusesfinalize.sevdesk_link_transactiononly takes open bank transactions and checks every voucher and the total before the first booking.sevdesk_reset_voucher_to_openis marked destructive. Both refuse foreign-currency vouchers.sevdesk_delete_voucherandsevdesk_set_transaction_privateare booking tools as well.sevdesk_set_tax_ruleandsevdesk_mark_invoice_sentrefuse enshrined documents and verify their changes by reading the document back.The ledger-cleanup tools check the object's status before every write (only drafts are deleted or corrected, only open transactions are marked private) and refuse enshrined ones.
sevdesk_delete_voucheris the only tool that cannot be undone; it carries the MCPdestructiveHint.There is deliberately no email-send tool, and
sevdesk_get_invoice_pdfnever overwrites an existing file.Booked and paid vouchers are deliberately out of scope for API rebooking. The sevDesk API only updates drafts, and resetting a paid foreign-currency voucher recalculates its EUR amounts at today's exchange rate — silently changing historical values. Correct booked vouchers in the sevDesk UI, where the original amounts stay visible against the receipt.
The tax model
With sevdesk-Update 2.0, sevDesk models VAT through taxRule — split into a revenue set and an expense set. Older documents still carry the deprecated taxType string; the server understands both generations.
Expense rules (incoming vouchers, creditDebit: "C"):
taxRule | Meaning | Rates | Legacy |
| Innergemeinschaftliche Erwerbe | 0 / 7 / 19 % | — |
| Vorsteuerabziehbare Aufwendungen | 0 / 7 / 19 % |
|
| Nicht vorsteuerabziehbare Aufwendungen | 0 % |
|
| Reverse Charge §13b Abs. 2, mit Vorsteuerabzug | 0 % | — |
| Reverse Charge §13b, ohne Vorsteuerabzug | 0 % | — |
| Reverse Charge §13b Abs. 1, EU | 0 % | — |
| Nicht steuerbar (Ausgabe) | 0 % | — |
Revenue rules (outgoing documents, creditDebit: "D"):
taxRule | Meaning | Rates | Legacy |
| Umsatzsteuerpflichtige Umsätze | 0 / 7 / 19 % |
|
| Ausfuhren | 0 % | — |
| Innergemeinschaftliche Lieferungen | 0 / 7 / 19 % |
|
| Steuerfreie Umsätze §4 UStG | 0 % | — |
| Reverse Charge §13b (Feld 60) | 0 % | — |
| Steuer nicht erhoben nach §19 UStG | 0 % |
|
| Nicht im Inland steuerbare Leistung | 0 % |
|
| Nicht steuerbar (Einnahme) | 0 % | — |
(Rules 18–21 — One Stop Shop and §18b — exist on invoices but are not accepted on vouchers; the audit flags them if they appear anyway.)
The classic mis-booking: a subscription from a supplier established abroad, booked as a plain domestic expense (taxRule 9) with a 0 % position. It looks harmless — reverse charge nets to zero for anyone with input-tax deduction — but it silently drops the §13b tax base out of your VAT return. The correct booking is taxRule 12 (or 13/14, depending on your situation). A CSV export cannot show you the difference, because it only carries the rate, not the rule. sevdesk_audit_vat finds it.
Development
npm run dev # run from source
npm test # unit tests
npm run typecheck # tsc --noEmit
npm run build:catalog # regenerate the operation catalogue from openapi/sevdesk-openapi.yamlSee CONTRIBUTING.md.
Roadmap
Live validation against a real account (bookkeeping system 2.0)
Contact-country detection, booking-account guidance checks, bank reconciliation
Guarded invoice workflow (draft-only creation, PDF export, mark-as-sent)
Remote hosting via the Streamable HTTP transport with a per-request token — server assembly is already transport-agnostic (
src/server.ts)Compile-time endpoint types generated from the OpenAPI spec
Integration tests against a sevDesk sandbox
Export helpers for the annual VAT return (Kz 46 / 47)
License
MIT
Available Tools
26 toolssevdesk_audit_vatAudit VAT treatment of vouchersBRead-only
Sweep vouchers (Belege) and flag VAT problems: foreign suppliers booked as plain domestic expenses (taxRule 9/10) instead of Reverse Charge §13b (taxRule 12/13/14), revenue rules sitting on expense vouchers, tax rates that contradict the chosen rule, sums that do not add up, and the same supplier booked inconsistently across vouchers. Read-only.
Inputs: to, from, maxVouchers, includePositions.
sevdesk_callCall any sevDesk API operationADestructive
Execute any operation from the catalogue. Path parameters are taken from params by name; remaining params entries become query parameters. Nested objects are encoded in sevDesk's bracket syntax (a[b]=c). Mutating operations are refused when the server runs with SEVDESK_READ_ONLY=true, and are only described (not sent) when SEVDESK_DRY_RUN=true or dryRun is passed. Operations with a preventSendBy query parameter (the *GetPdf reads) default it to true so a read does not mark the document as sent. GETs that change state (sendByWithRender, enshrine flags, preventSendBy=false) count as writes. Booking operations (bookVoucher, bookInvoice, bookCreditNote, their resetToOpen and resetToDraft, createPrivateTransactionRule) and writes that set a transaction status or move a voucher out of draft or mark it paid (updateCheckAccountTransaction, updateVoucher, voucherFactorySaveVoucher) are refused unless SEVDESK_ALLOW_BOOKING=true; prefer sevdesk_link_transaction for vouchers. Can call DELETE operations, which are irreversible. ⚠️ This tool can change data in sevDesk.
Inputs: operationId (required), body, dryRun, params.
sevdesk_create_invoiceCreate a draft invoiceA
Create an outgoing invoice as a draft (status 50) — always a draft, so nothing reaches a customer without review in sevDesk. Positions carry name, quantity, price and tax rate; the contact's address is filled in automatically. Honors SEVDESK_DRY_RUN. ⚠️ This tool can change data in sevDesk.
Inputs: contactId (required), positions (required), taxRuleId (required), dryRun, +3 more.
sevdesk_create_voucherCreate a voucherA
Create a voucher via /Voucher/Factory/saveVoucher. Defaults to status 50 (Entwurf) so nothing is booked without you reviewing it in sevDesk. Check sevdesk_receipt_guidance for the account's allowed tax rules first — expense-side reverse charge is 12/13/14, not 5. WRITE operation. For anything this wrapper does not cover, use sevdesk_call with operationId 'voucherFactorySaveVoucher'. ⚠️ This tool can change data in sevDesk.
Inputs: positions (required), taxRuleId (required), voucherDate (required), supplierName (required), +7 more.
sevdesk_describe_operationDescribe a sevDesk API operationARead-only
Show the full parameter list, request-body shape and an example call for one operationId. Always do this before sevdesk_call on an operation you have not used before.
Inputs: operationId (required).
sevdesk_diff_receipt_folderDiff a receipt folder against sevDeskARead-only
Compare a local folder of receipt PDFs against the vouchers booked in sevDesk and report both directions: files that appear to have no voucher, and vouchers with no matching file. Matching uses the #reference in the filename first, then date + amount. Filenames are expected to look like '260626_Acme-Cloud_#INV-2043.pdf' or '2026-06-26_AcmeCloud_45.60.pdf'. Reads the filesystem but never writes; sevDesk access is read-only.
Inputs: directory (required), to, from, recursive, +3 more.
sevdesk_find_duplicatesFind duplicate and stuck vouchersARead-only
Detect vouchers booked twice (same document number, or same supplier + amount within a few days) and vouchers left in Entwurf/offen status. Read-only.
Inputs: to, from, dayWindow, maxVouchers.
sevdesk_get_invoice_pdfSave an invoice PDFARead-only
Fetch the rendered PDF of an invoice and save it into a directory from the SEVDESK_RECEIPT_DIRS allowlist. Never changes the invoice's send state (preventSendBy). Read-only towards sevDesk.
Inputs: directory (required), invoiceId (required).
sevdesk_get_voucherGet one voucher with its positionsARead-only
Fetch a single voucher including its line items, with the VAT treatment and per-position tax rates decoded. Read-only.
Inputs: voucherId (required).
sevdesk_invoice_agingOverdue invoices (receivables aging)ARead-only
Who owes you money and for how long: open and partially paid invoices bucketed by days overdue (invoice date + payment terms), the outstanding remainder per invoice, drafts that were never sent, and open invoices missing a send mark. Read-only.
Inputs: to, from, maxItems.
sevdesk_list_contactsList contactsBRead-only
List customers and suppliers. Read-only.
Inputs: limit, search, maxItems.
sevdesk_list_invoicesList outgoing invoicesBRead-only
List invoices you issued, with number, customer, sums, status and dates. Read-only.
Inputs: to, from, limit, maxItems.
sevdesk_list_operationsList sevDesk API operationsARead-only
Search the sevDesk API catalogue (154 operations, API 2.0.0) for the operationId of anything not covered by a dedicated tool. Available tags: AccountingContact, Basics, CheckAccount, CheckAccountTransaction, CommunicationWay, Contact, ContactAddress, ContactField, CreditNote, CreditNotePos, Export, Invoice, InvoicePos, Layout, Order, OrderPos, Part, PrivateTransactionRule, Report, Tag, Voucher, VoucherPos.
Inputs: tag, kind, limit, query.
sevdesk_list_transactionsList bank transactionsBRead-only
List bank transactions, optionally for one account and period. Read-only.
Inputs: to, from, limit, maxItems, +1 more.
sevdesk_list_vouchersList vouchers (Belege)BRead-only
List incoming/outgoing vouchers with the fields that matter for bookkeeping: date, supplier, gross/net/tax, status and the decoded VAT treatment. Read-only.
Inputs: to, from, limit, status, +2 more.
sevdesk_mark_invoice_sentMark an invoice as sentA
Mark an invoice as sent without emailing anything (send types: PDF download, print, postal — deliberately no email). Refuses enshrined invoices and verifies the result. Honors SEVDESK_DRY_RUN. ⚠️ This tool can change data in sevDesk.
Inputs: invoiceId (required), dryRun, sendType.
sevdesk_pingCheck the sevDesk connectionARead-only
Verify the API token, report server mode, bookkeeping generation (1.0 taxType / 2.0 taxRule). Run this first.
Inputs: no named parameters.
sevdesk_receipt_guidanceBooking-account guidanceARead-only
sevDesk's own booking guidance: which DATEV/SKR accounts exist for expenses or revenue and which tax rules and rates each of them allows — the table sevDesk validates against when a voucher is booked. Filter by text, account number or tax rule; output is capped, never the full account dump. Read-only.
Inputs: side, limit, query, taxRuleId, +1 more.
sevdesk_reconcile_transactionsReconcile bank transactions with vouchersARead-only
Match bank transactions against vouchers by amount and date proximity, in both directions: payments with no plausible voucher (missing receipts) and non-draft vouchers no payment covers. Matching is a heuristic — treat the result as a checklist, not a verdict. Read-only.
Inputs: to, from, maxItems, dayWindow.
sevdesk_reverse_charge_reportReverse-charge (§13b) reportARead-only
Total the reverse-charge (§13b) tax base for a period, split by meaning: expense vouchers with input-tax deduction (taxRule 12/14, nets to zero), without deduction (taxRule 13, VAT actually payable), and your own §13b revenue (taxRule 5). Separately lists vouchers that look like they belong in the report but are not booked that way. Read-only.
Inputs: to, from, rate, maxVouchers.
sevdesk_set_tax_ruleChange a voucher's tax ruleA
Rebook a voucher onto a different VAT rule (e.g. from 'Vorsteuerabziehbare Aufwendungen' onto Reverse Charge §13b, taxRule 12) with guardrails: refuses enshrined vouchers and rules from the wrong side of the books, verifies the result afterwards, and previews the request with dryRun. The voucher's positions keep their rates. Only works on draft vouchers — the sevDesk API refuses updates on booked/paid ones, and resetting a paid foreign-currency voucher via the API recalculates its EUR amounts at today's rate. Correct paid vouchers in the sevDesk UI instead. ⚠️ This tool can change data in sevDesk.
Inputs: taxRuleId (required), voucherId (required), dryRun.
sevdesk_subscription_gapsFind gaps in recurring supplier chargesARead-only
Detect suppliers that bill on a monthly cadence and report months with no voucher. A subscription that appears in March, April and June but not May almost always means a receipt was never entered. Read-only.
Inputs: to, from, minMonths, maxVouchers.
sevdesk_summarizeSummarize invoices or vouchers (totals, not rows)ARead-only
Aggregate invoices or vouchers over a date range WITHOUT returning rows: counts plus net/tax/gross sums, grouped by month, status, contact or nothing. Use this for totals ('revenue in Q2', 'expenses by supplier') instead of the list tools — the response stays small however large the ledger is. Read-only.
Inputs: kind (required), to, from, side, +3 more.
sevdesk_update_draft_voucherCorrect a draft voucherA
Correct a draft voucher (status 50, Entwurf): date, document number, supplier name, tax rule and the positions (amounts, tax rate, booking account). positions replaces all positions: give the full new list; existing positions are reused in order (they keep their booking account unless accountDatevId is given), extra old ones are deleted. Example: gross 214.20 booked at 0 % -> positions [{sumNet: 180, taxRate: 19}] gives 180.00 + 34.20 VAT = 214.20. Positions you do not replace are sent back as they were entered, net or gross. A new taxRuleId is checked against the voucher's side (expense or revenue) and its position rates. finalize=true also sets the voucher to open (100), needed before sevdesk_link_transaction; every position then needs a booking account. finalize is refused unless the server runs with SEVDESK_ALLOW_BOOKING=true; without it the draft can still be corrected. Refuses open, paid and enshrined vouchers; keeps the attached file; verifies sums and status afterwards. ⚠️ This tool can change data in sevDesk.
Inputs: voucherId (required), dryRun, finalize, positions, +4 more.
sevdesk_upload_voucher_fileUpload a receipt file to sevDeskA
Upload a local PDF/image/XML e-invoice to sevDesk's temporary voucher storage and return the filename token you pass to sevdesk_create_voucher. WRITE operation — refused under SEVDESK_READ_ONLY. ⚠️ This tool can change data in sevDesk.
Inputs: filePath (required), dryRun, mimeType.
sevdesk_upload_voucher_file_contentUpload a receipt file (inline)A
Upload a receipt sent inline as base64 (e.g. an e-mail attachment) to sevDesk's temporary voucher storage — for hosted clients that cannot use sevdesk_upload_voucher_file's local path. Returns fileName, the token sevdesk_create_voucher attaches to a new voucher. PDF, PNG, JPG and XML (XRechnung / ZUGFeRD e-invoice) only, checked by content and not only the name, at most 10 MB. Accepts standard and URL-safe base64 and data: URLs. Creates no voucher by itself. ⚠️ This tool can change data in sevDesk.
Inputs: fileName (required), base64Content (required), dryRun.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 26 tools
Most tools have clearly distinct targets: reads (list_vouchers, list_invoices, get_voucher), writes (create_voucher, create_invoice, update_draft_voucher, set_tax_rule), diagnostics (audit_vat, find_duplicates, subscription_gaps, diff_receipt_folder, reconcile_transactions) and API escape hatches (list_operations, describe_operation, call). The weakest boundaries are sevdesk_set_tax_rule vs. sevdesk_update_draft_voucher (both can rebook a draft's tax rule) and the four receipt-gap detectors, which a hurried agent could confuse even though the descriptions differentiate them (filesystem, bank transactions, duplicates, subscription cadence). sevdesk_call overlaps every dedicated tool by design, but is explicitly framed as the fallback.
All 26 tools share a sevdesk_ prefix and snake_case, so the family is instantly recognisable and the verb_noun pattern dominates (list_vouchers, get_voucher, create_invoice, mark_invoice_sent, find_duplicates). A handful of names drop the verb (invoice_aging, receipt_guidance, reverse_charge_report, subscription_gaps) and ping is a bare verb, which are minor but real deviations from the pattern.
26 tools is at the heavy end: the domain is genuinely broad (vouchers, invoices, contacts, bank transactions, VAT audits, file upload, plus a generic API gateway), so most tools earn their place rather than duplicating each other. Still, an agent has to triage a large surface, and a few niche diagnostics (subscription_gaps, reverse_charge_report) could plausibly have been folded into summarize/audit_vat.
Coverage is broad — read, aggregate, create, correct, upload, PDF export, send-marking and a generic catalogue gateway that can reach all 154 sevDesk operations — but there are notable holes: no delete operations, no contact or transaction write tools, and no explicit payment/booking tool. Most damaging, sevdesk_link_transaction is referenced twice inside other descriptions ('needed before sevdesk_link_transaction', 'prefer sevdesk_link_transaction') yet is absent from the tool set, leaving a dangling pointer that will send agents chasing a nonexistent tool (the call gateway is the only workaround).
Maintenance
Related MCP Connectors
MCP server for ABRA Flexi — accounting, contacts, stock and draft-checked invoice creation.
MCP server for MOCO business software: time tracking, projects, budgets, and invoicing via API
Hosted MCP server for OTTO Market, Kaufland and Mirakl sellers: orders, stock, listings and ads.
sevdesk MCP server for ChatGPT, Claude and any AI agent: create invoice, send invoice, upload receipt, book voucher and list open invoices in your own sevdesk account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to sevdesk yourself; Cotlet does not store your password and you need no sevdesk API key. About the official sevdesk API: sevdesk has a REST API (checked 14 Oct 2026). It covers almost everything the web app does, but only on the Buchhaltung Pro plan, in Germany, on system version 2.0. Setup and FAQ: https://cotlet.dev/integrations/sevdesk-api-mcp-server
Related MCP Servers
- FlicenseBqualityDmaintenanceMCP server for DACH accounting automation. Connect AI assistants to sevDesk and Lexoffice — create invoices, manage contacts, handle bookings and vouchers for German-speaking businesses.1555 npm-
- AlicenseNot gradedqualityDmaintenanceA local MCP server for analyzing DATEV bookkeeping data in natural language. It reads EXTF export files locally and provides tools for balances, open items, and booking search.6MIT
- AlicenseNot gradedqualityCmaintenanceMCP server providing deterministic accounting tools for AI agents, including bank statement parsing, document classification, money math, and webhook verification.2Apache 2.0
- AlicenseAqualityCmaintenanceMCP server providing access to the easybill REST API for managing invoices, customers, articles, payments, projects, and time tracking, with read-only mode by default.28410 npmMIT