Name: Sevdesk
Author: usefulapi

Sevdesk MCP

Look up contacts, invoices, vouchers, orders, bank transactions and parts, and create drafts.

not scanned Remote · Streamable HTTP No auth needed 20 tools v1.11.1

No reviews yet by usefulapiGitHub The publisher’s own endpoint — this marketplace is not in the path

tools declared

—

trust score

remote

at its publisher

—

calls last 7d

What it does

Look up contacts, invoices, vouchers, orders, bank transactions and parts, and create drafts.

Quickstart

# 1 — add it to Claude Code
claude mcp add --scope user --transport http usefulapi-sevdesk-mcp https://sevdesk.usefulapi.io/mcp

# 2 — ask your agent for something these tools do
#   sevdesk_get_bookkeeping_system_version, sevdesk_list_contacts, sevdesk_get_contact and 17 more

Sevdesk costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.

Publishernot claimed

usefulapi334 servers

24 categories

All 334 servers

Collected from a public index. Nobody has claimed this account, so nothing here was written by its author — claim it if it is yours.

Tool surface

What the model actually sees. Descriptions are diffed on every release — see version history.

Only tools that write or reach the network

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.

No parameter schema on file.

List contacts (customers, suppliers, partners, prospects). By default sevdesk returns only organisations; set include_persons to also get individual persons. sevdesk: GET /Contact.

Parameter	Type	Required	Notes
include_persons	boolean	no	If true, return organisations AND persons (sevdesk depth=1). Default: organisations only.
name	string	no	Only contacts whose name, first name or last name matches.
customer_number	string	no	Only the contact with this customer number.
city	string	no	Only contacts in this city.
zip	string	no	Only contacts with this ZIP code.
category_id	integer	no	Only contacts in this category: 2 Supplier, 3 Customer, 4 Partner, 28 Prospect customer.
parent_id	integer	no	Only persons belonging to this parent organisation's id.
limit	integer	no	Max entries to return, 1-1000 (sevdesk suggests 10-100).
offset	integer	no	Number of entries to skip, for paging.
count_all	boolean	no	If true, the response also carries total, the full match count.
embed	string	no	Comma-separated nested resources to expand inline, e.g. contact,category.

Fetch a single contact by id. sevdesk: GET /Contact/{contactId}.

Parameter	Type	Required	Notes
contact_id	integer	yes	The contact's numeric id.
embed	string	no	Comma-separated nested resources to expand inline, e.g. contact,category.

List communication ways (email addresses, phone and mobile numbers, websites), optionally for one contact. sevdesk: GET /CommunicationWay.

Parameter	Type	Required	Notes
contact_id	integer	no	Only this contact's communication ways.
type	string	no	Only this type.
main_only	boolean	no	If true, only the main communication way(s).
limit	integer	no	Max entries to return, 1-1000 (sevdesk suggests 10-100).
offset	integer	no	Number of entries to skip, for paging.
count_all	boolean	no	If true, the response also carries total, the full match count.
embed	string	no	Comma-separated nested resources to expand inline, e.g. contact,category.

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.

No parameter schema on file.

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.

Parameter	Type	Required	Notes
status	string	no	Only invoices with this status code.
invoice_number	string	no	Only the invoice with this number.
start_date	integer	no	Only invoices dated on or after this, as a Unix timestamp in seconds.
end_date	integer	no	Only invoices dated on or before this, as a Unix timestamp in seconds.
contact_id	integer	no	Only invoices for this contact id.
delinquent	boolean	no	If true, only overdue (delinquent) invoices.
invoice_type	string	no	Only this type: RE normal, WKR recurring, SR cancellation, MA reminder, TR partial, AR advance, ER final.
limit	integer	no	Max entries to return, 1-1000 (sevdesk suggests 10-100).
offset	integer	no	Number of entries to skip, for paging.
count_all	boolean	no	If true, the response also carries total, the full match count.
embed	string	no	Comma-separated nested resources to expand inline, e.g. contact,category.

Fetch a single invoice by id — totals, status, dates, contact and contact person. sevdesk: GET /Invoice/{invoiceId}.

Parameter	Type	Required	Notes
invoice_id	integer	yes	The invoice's numeric id.
embed	string	no	Comma-separated nested resources to expand inline, e.g. contact,category.

List the positions (line items) of one invoice: name, quantity, price, tax rate, sums. sevdesk: GET /Invoice/{invoiceId}/getPositions.

Parameter	Type	Required	Notes
invoice_id	integer	yes	The invoice's numeric id.
limit	integer	no	Max entries to return, 1-1000 (sevdesk suggests 10-100).
offset	integer	no	Number of entries to skip, for paging.
embed	string	no	Comma-separated nested resources to expand inline, e.g. contact,category.

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.

Parameter	Type	Required	Notes
status	string	no	Only vouchers with this status code.
credit_debit	string	no	C for credit (revenue) or D for debit (expense) vouchers.
description_like	string	no	Only vouchers whose description contains this text.
start_date	integer	no	Only vouchers dated on or after this, as a Unix timestamp in seconds.
end_date	integer	no	Only vouchers dated on or before this, as a Unix timestamp in seconds.
contact_id	integer	no	Only vouchers for this contact id.
limit	integer	no	Max entries to return, 1-1000 (sevdesk suggests 10-100).
offset	integer	no	Number of entries to skip, for paging.
count_all	boolean	no	If true, the response also carries total, the full match count.
embed	string	no	Comma-separated nested resources to expand inline, e.g. contact,category.

Fetch a single voucher (receipt) by id. sevdesk: GET /Voucher/{voucherId}.

Parameter	Type	Required	Notes
voucher_id	integer	yes	The voucher's numeric id.
embed	string	no	Comma-separated nested resources to expand inline, e.g. contact,category.

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.

Parameter	Type	Required	Notes
status	string	no	Only credit notes with this status code.
credit_note_number	string	no	Only the credit note with this number.
start_date	integer	no	Only credit notes dated on or after this, as a Unix timestamp in seconds.
end_date	integer	no	Only credit notes dated on or before this, as a Unix timestamp in seconds.
contact_id	integer	no	Only credit notes for this contact id.
limit	integer	no	Max entries to return, 1-1000 (sevdesk suggests 10-100).
offset	integer	no	Number of entries to skip, for paging.
count_all	boolean	no	If true, the response also carries total, the full match count.
embed	string	no	Comma-separated nested resources to expand inline, e.g. contact,category.

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.

Parameter	Type	Required	Notes
status	string	no	Only orders with this status code.
order_number	string	no	Only the order with this number.
start_date	integer	no	Only orders dated on or after this, as a Unix timestamp in seconds.
end_date	integer	no	Only orders dated on or before this, as a Unix timestamp in seconds.
contact_id	integer	no	Only orders for this contact id.
limit	integer	no	Max entries to return, 1-1000 (sevdesk suggests 10-100).
offset	integer	no	Number of entries to skip, for paging.
count_all	boolean	no	If true, the response also carries total, the full match count.
embed	string	no	Comma-separated nested resources to expand inline, e.g. contact,category.

List parts — the products and services in the sevdesk inventory, with prices, tax rate and stock. sevdesk: GET /Part.

Parameter	Type	Required	Notes
part_number	string	no	Only the part with this part number.
name	string	no	Only parts with this name.
limit	integer	no	Max entries to return, 1-1000 (sevdesk suggests 10-100).
offset	integer	no	Number of entries to skip, for paging.
count_all	boolean	no	If true, the response also carries total, the full match count.
embed	string	no	Comma-separated nested resources to expand inline, e.g. contact,category.

List check accounts — the bank accounts, cash registers and clearing accounts sevdesk tracks payments on, with IBAN, type and sync status. sevdesk: GET /CheckAccount.

Parameter	Type	Required	Notes
limit	integer	no	Max entries to return, 1-1000 (sevdesk suggests 10-100).
offset	integer	no	Number of entries to skip, for paging.
count_all	boolean	no	If true, the response also carries total, the full match count.
embed	string	no	Comma-separated nested resources to expand inline, e.g. contact,category.

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.

Parameter	Type	Required	Notes
check_account_id	integer	yes	The check account's numeric id.
date	string	yes	Consider transactions up to this date (YYYY-MM-DD, inclusive to 23:59:59).

List check-account transactions (bank payments in and out), filterable by account, booking state, date range, payee/payer and purpose. sevdesk: GET /CheckAccountTransaction.

Parameter	Type	Required	Notes
check_account_id	integer	no	Only transactions on this check account id.
is_booked	boolean	no	If true, only transactions already booked against a document.
payment_purpose	string	no	Only transactions with this payment purpose (Verwendungszweck).
payee_payer_name	string	no	Only transactions with this payee / payer name.
start_date	string	no	Only transactions from this date on (ISO 8601, e.g. 2026-01-01).
end_date	string	no	Only transactions up to this date (ISO 8601).
only_credit	boolean	no	If true, only incoming (credit) transactions.
only_debit	boolean	no	If true, only outgoing (debit) transactions.
limit	integer	no	Max entries to return, 1-1000 (sevdesk suggests 10-100).
offset	integer	no	Number of entries to skip, for paging.
count_all	boolean	no	If true, the response also carries total, the full match count.
embed	string	no	Comma-separated nested resources to expand inline, e.g. contact,category.

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.

Parameter	Type	Required	Notes
name	string	no	Organisation name. Setting it makes the contact an ORGANISATION — leave empty for a person.
surename	string	no	First name of a PERSON (sevdesk's field is really spelled 'surename').
familyname	string	no	Last name of a PERSON.
customer_number	string	no	Customer number. Omit to let sevdesk leave it unset.
status		no	100 Lead, 500 Pending, 1000 Active.
description	string	no	Free-text description.
vat_number	string	no	VAT id (USt-IdNr.).
tax_number	string	no	Tax number (Steuernummer).
default_time_to_pay	integer	no	Default payment term in days for this contact's invoices.
parent_id	integer	no	For a person: the id of the organisation they belong to.
category_id	integer	yes	Required category: 2 Supplier, 3 Customer, 4 Partner, 28 Prospect customer.

Update fields on an existing contact; only the fields you pass are sent. sevdesk: PUT /Contact/{contactId}.

Parameter	Type	Required	Notes
contact_id	integer	yes	The contact's numeric id.
name	string	no	Organisation name. Setting it makes the contact an ORGANISATION — leave empty for a person.
surename	string	no	First name of a PERSON (sevdesk's field is really spelled 'surename').
familyname	string	no	Last name of a PERSON.
customer_number	string	no	Customer number. Omit to let sevdesk leave it unset.
status		no	100 Lead, 500 Pending, 1000 Active.
description	string	no	Free-text description.
vat_number	string	no	VAT id (USt-IdNr.).
tax_number	string	no	Tax number (Steuernummer).
default_time_to_pay	integer	no	Default payment term in days for this contact's invoices.
parent_id	integer	no	For a person: the id of the organisation they belong to.
category_id	integer	no	Move to category: 2 Supplier, 3 Customer, 4 Partner, 28 Prospect.

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.

Parameter	Type	Required	Notes
contact_id	integer	yes	The contact's numeric id.
type	string	yes	What kind of value this is.
value	string	yes	The email address, number or URL.
key_id	integer	no	Communication way key id (1 Privat, 2 Arbeit, 3 Fax, 4 Mobil, 8 Rechnungsadresse). Default 2.
main	boolean	no	Make this the contact's main communication way of its type.

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 i

Parameter	Type	Required	Notes
contact_id	integer	yes	The contact (customer)'s numeric id.
contact_person_id	integer	yes	Id of the sevdesk user (SevUser) acting as contact person — e.g. contactPerson.id of an existing invoice.
invoice_date	string	yes	Invoice date as dd.mm.yyyy.
positions	array	yes	Line items (at least one).
tax_rule_id	string	no	Bookkeeping 2.0 VAT rule id. 1 taxable sales (Umsatzsteuerpflichtige Umsätze), 2 exports, 3 intra-EU supplies, 4 tax-free §4 UStG, 5 reverse charge §13b, 11 small business §19 (Kleinunternehmer), 17 n
tax_type	string	no	Bookkeeping 1.0 only — leave unset on 2.0 accounts.
tax_text	string	no	VAT text printed on the invoice. Default 'Umsatzsteuer 19%'.
currency	string	no	ISO-4217 currency code. Default EUR.
address_country_id	integer	no	sevdesk StaticCountry id of the billing address (1 = Germany). Default 1.
address	string	no	Complete recipient address with line breaks. Omit to leave it empty.
header	string	no	Invoice header/title line.
head_text	string	no	Text above the line items (some HTML allowed).
foot_text	string	no	Text below the line items (some HTML allowed).
time_to_pay	integer	no	Payment term in days.
delivery_date	string	no	Delivery / service date as dd.mm.yyyy (must not be after invoice_date for a normal invoice).
show_net	boolean	no	If true (default), position prices are net.
small_settlement	boolean	no	True if the account uses the small-business scheme (no VAT).
customer_internal_note	string	no	Reference / order number field.

Free

$0 forever

Every tool — any call limit is its publisher’s, not ours
No card, and mcprush charges nothing for it
Runs at its publisher’s own address — this marketplace is not in the path
Nothing to cap, because mcprush bills nothing

Nothing here is billable: mcprush charges nothing to install Sevdesk or to call it, at any volume.

Where are you running it?

Tool surface

Release history

Sevdesk MCP

What it does

Quickstart

Where are you running it?

Tool surface

What counts against your monthly calls

Release history

See also