Look up contacts, invoices, vouchers, orders, bank transactions and parts, and create drafts. Hosted by usefulapi — connect from Claude, Cursor, or any MCP client.
Add to your MCP config, then reload & authorize:
{
"mcpServers": {
"sevdesk": {
"url": "https://sevdesk.usefulapi.io/mcp"
}
}
}| Tool | Type | What it does |
|---|---|---|
sevdesk_get_bookkeeping_system_version | read | Get the bookkeeping system version Return whether the account runs sevdesk bookkeeping 1.0 or 2.0 (2.0 uses taxRule instead of taxType on invoices). Also a cheap way to confirm the API token works. sevdesk: GET /Tools/bookkeepingSystemVersion. |
sevdesk_list_contacts | read | List contacts List contacts (customers, suppliers, partners, prospects). By default sevdesk returns only organisations; set include_persons to also get individual persons. sevdesk: GET /Contact. |
sevdesk_get_contact | read | Get one contact Fetch a single contact by id. sevdesk: GET /Contact/{contactId}. |
sevdesk_list_communication_ways | read | List contact emails, phones and websites List communication ways (email addresses, phone and mobile numbers, websites), optionally for one contact. sevdesk: GET /CommunicationWay. |
sevdesk_list_communication_way_keys | read | List communication way keys List the labels a communication way can carry (1 Privat, 2 Arbeit, 3 Fax, 4 Mobil, 6 Autobox, 7 Newsletter, 8 Rechnungsadresse). Needed for sevdesk_add_communication_way. sevdesk: GET /CommunicationWayKey. |
sevdesk_list_invoices | read | List invoices List invoices, filterable by status, number, date range and contact. Status: 50 deactivated recurring, 100 draft, 200 open/due, 750 partially paid, 1000 paid. sevdesk: GET /Invoice. |
sevdesk_get_invoice | read | Get one invoice Fetch a single invoice by id — totals, status, dates, contact and contact person. sevdesk: GET /Invoice/{invoiceId}. |
sevdesk_get_invoice_positions | read | Get an invoice's line items List the positions (line items) of one invoice: name, quantity, price, tax rate, sums. sevdesk: GET /Invoice/{invoiceId}/getPositions. |
sevdesk_list_vouchers | read | List vouchers (receipts) List vouchers — receipts and incoming/outgoing bills. Status: 50 draft, 100 unpaid/due, 1000 paid. credit_debit C = credit (revenue), D = debit (expense). sevdesk: GET /Voucher. |
sevdesk_get_voucher | read | Get one voucher Fetch a single voucher (receipt) by id. sevdesk: GET /Voucher/{voucherId}. |
sevdesk_list_credit_notes | read | List credit notes List credit notes (Gutschriften), filterable by status, number, date range and contact. Status: 100 draft, 200 open/delivered, 750 partially paid, 1000 paid. sevdesk: GET /CreditNote. |
sevdesk_list_orders | read | List orders and quotes List orders — quotes (Angebote), order confirmations and delivery notes — filterable by status, number, date range and contact. Status: 100 draft, 200 delivered, 300 rejected, 500 accepted, 750 partially calculated, 1000 calculated. sevdesk: GET /Order. |
sevdesk_list_parts | read | List parts (products) List parts — the products and services in the sevdesk inventory, with prices, tax rate and stock. sevdesk: GET /Part. |
sevdesk_list_check_accounts | read | List payment accounts List check accounts — the bank accounts, cash registers and clearing accounts sevdesk tracks payments on, with IBAN, type and sync status. sevdesk: GET /CheckAccount. |
sevdesk_get_check_account_balance | read | Get a payment account's balance at a date Balance of one check account as the sum of every transaction sevdesk knows up to and including the given date. May differ from the real bank balance if older transactions were never imported. sevdesk: GET /CheckAccount/{checkAccountId}/getBalanceAtDate. |
sevdesk_list_transactions | read | List bank transactions List check-account transactions (bank payments in and out), filterable by account, booking state, date range, payee/payer and purpose. sevdesk: GET /CheckAccountTransaction. |
sevdesk_create_contact | write | Create a contact Create a contact. Give `name` for an organisation, or `surename`/`familyname` for a person. Addresses and emails are separate (use sevdesk_add_communication_way). sevdesk: POST /Contact. |
sevdesk_update_contact | write | Update a contact Update fields on an existing contact; only the fields you pass are sent. sevdesk: PUT /Contact/{contactId}. |
sevdesk_add_communication_way | write | Add an email, phone or website to a contact Attach an email address, phone/mobile number or website to a contact. key_id labels it (2 Arbeit/work is a good default; see sevdesk_list_communication_way_keys). sevdesk: POST /CommunicationWay. |
sevdesk_create_draft_invoice | write | Create a draft invoice Create a normal invoice (type RE) with its line items, ALWAYS saved as a DRAFT (status 100): it is not sent, not booked and stays editable in sevdesk. contact_person_id is the sevdesk USER responsible for it — copy contactPerson.id from any existing invoice (sevdesk_get_invoice). Bookkeeping 2.0 accounts use tax_rule_id (1 = taxable sales in Germany, the usual choice); 1.0 accounts pass tax_type instead (check sevdesk_get_bookkeeping_system_version). sevdesk: POST /Invoice/Factory/saveInvoice. |
sevdesk_usage_status | Usage status (free-tier meter) Report the caller's current free-tier usage this month: calls used, monthly limit, remaining, and whether the cap is reached. Read-only; does not count against the meter. | |
sevdesk_upgrade | Upgrade to Pro (unlimited) Subscribe to the Pro plan for UNLIMITED sevdesk tool calls (the free tier caps monthly usage). Choose monthly ($9/month) or yearly ($90/year — 2 months free) billing. Returns a Stripe Checkout link to open in your browser; after payment your account upgrades automatically. Read-only; does not count against the meter. |
| Plan | Price | Limit |
|---|---|---|
| Free | $0 | 100 tool calls / month |
| Proper user | $9/mo · $90/yr | Unlimited |
This is a Model Context Protocol endpoint — meant to be connected from an AI client, not opened in a browser. An invalid_token response at the URL is the auth gate working as designed; clients authenticate automatically.