sevdesk-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SEVDESK_DRY_RUN | No | Show what a write would send, without sending it | false |
| SEVDESK_BASE_URL | No | Override the API host | https://my.sevdesk.de/api/v1 |
| SEVDESK_API_TOKEN | Yes | Your sevDesk API token | |
| SEVDESK_READ_ONLY | No | Hide write tools; sevdesk_call stays listed but refuses mutating operations at call time | false |
| SEVDESK_TIMEOUT_MS | No | Per-request timeout | 30000 |
| SEVDESK_MAX_RETRIES | No | Retries on 429/5xx, with backoff and Retry-After | 3 |
| SEVDESK_RECEIPT_DIRS | No | Colon-separated allowlist of directories the receipt file tools may read and write | |
| SEVDESK_KLEINUNTERNEHMER | No | §19 UStG small-business scheme: audit suggestions point to the KU rule set (13/10/11), new invoices default to rule 11 at 0 % | false |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| sevdesk_pingA | Verify that the API token works, report the server mode (read-only / dry-run) and the account's bookkeeping system version (1.0 uses taxType, 2.0 uses taxRule). Run this first when something behaves unexpectedly. |
| sevdesk_list_vouchersB | List incoming/outgoing vouchers with the fields that matter for bookkeeping: date, supplier, gross/net/tax, status and the decoded VAT treatment. Read-only. |
| sevdesk_get_voucherA | Fetch a single voucher including its line items, with the VAT treatment and per-position tax rates decoded. Read-only. |
| sevdesk_list_invoicesA | List invoices you issued, with number, customer, sums, status and dates. Read-only. |
| sevdesk_list_contactsB | List customers and suppliers. Read-only. |
| sevdesk_list_transactionsA | List bank transactions, optionally for one account and period. Read-only. |
| sevdesk_upload_voucher_fileA | Upload a local PDF/image 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. |
| sevdesk_create_voucherA | Create a voucher via /Voucher/Factory/saveVoucher. Defaults to status 50 (Entwurf) so nothing is booked without you reviewing it in sevDesk. Set taxRule 5 for Reverse Charge §13b, 1 for normal domestic VAT, 3 for intra-EU. WRITE operation. For anything this wrapper does not cover, use sevdesk_call with operationId 'voucherFactorySaveVoucher'. ⚠️ This tool can change data in sevDesk. |
| sevdesk_receipt_guidanceA | 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. |
| sevdesk_set_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. |
| sevdesk_create_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. |
| sevdesk_get_invoice_pdfA | 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. |
| sevdesk_mark_invoice_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. |
| sevdesk_audit_vatA | 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. This is the check that tells you whether your §13b amounts will be reported correctly in the VAT return. |
| sevdesk_reverse_charge_reportA | 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. |
| sevdesk_find_duplicatesB | Detect vouchers booked twice (same document number, or same supplier + amount within a few days) and vouchers left in Entwurf/offen status. Read-only. |
| sevdesk_subscription_gapsA | 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. |
| sevdesk_diff_receipt_folderA | 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. |
| sevdesk_reconcile_transactionsA | 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. |
| sevdesk_invoice_agingA | 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. |
| sevdesk_list_operationsA | Search the sevDesk API catalogue (151 operations, API 2.0.0). Use this to find the operationId for anything not covered by a dedicated tool, then call sevdesk_describe_operation for its parameters and sevdesk_call to execute it. Available tags: AccountingContact, Basics, CheckAccount, CheckAccountTransaction, CommunicationWay, Contact, ContactAddress, ContactField, CreditNote, CreditNotePos, Export, Invoice, InvoicePos, Layout, Order, OrderPos, Part, Report, Tag, Voucher, VoucherPos. |
| sevdesk_describe_operationA | 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. |
| sevdesk_callA | Execute any operation from the catalogue. Path parameters are taken from |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/joosthel/sevdesk-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server