Integration

sevdesk integration

sevdesk is a German cloud accounting and invoicing service. Manage contacts with their addresses, communication ways, accounting numbers and custom fields; create and update invoices, orders (estimates, order confirmations, delivery notes) and credit notes with their positions, email them or mark them as sent, fetch their PDF, book payments against them, cancel invoices and create reminders; record vouchers (receipts), bank and clearing account transactions and parts (products) with stock; tag documents; start DATEV exports and export invoices, credit notes, vouchers, transactions or contacts as CSV. Document layout and template changes, PDF re-rendering, voucher file uploads, ZIP and PDF list reports and DATEV account settings are left to the sevdesk app. Authentication is the account's 32-character API token, sent as the raw value of the Authorization header.

Connect sevdesk How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in sevdesk.Built from the 140 sevdesk tools below, on the connection you add once.

What you can do with sevdesk

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Accounting contact, 4 operations

create_accounting_contactCreate accounting contactPOSTGives a contact a debitor and/or creditor number for bookkeeping.
delete_accounting_contactDelete accounting contactDELETEDeletes an accounting contact. sevdesk warns this can cause booking errors, especially in the DATEV export.
get_accounting_contactGet accounting contactGETReturns one accounting contact (debitor and creditor numbers of a contact).
list_accounting_contactsList accounting contactsGETLists accounting contacts: the debitor and creditor numbers sevdesk books a contact under. Filter by contact.

Check account transaction, 4 operations

create_transactionCreate transactionPOSTRecords a transaction on a check account; sevdesk advises a file import account (create_file_import_account) for payment entries created through the API.
delete_transactionDelete transactionDELETEDeletes a check account transaction.
get_transactionGet transactionGETReturns one check account transaction by id.
list_transactionsList transactionsGETLists bank transactions, filterable by check account, booked state, purpose, payee or payer, date range and credit or debit, with limit and offset paging.

Communication way, 4 operations

create_communication_wayCreate communication wayPOSTAdds an email address, phone, mobile number or website to a contact. key (the label, ids from list_communication_way_keys) is required.
delete_communication_wayDelete communication wayDELETEDeletes a communication way.
get_communication_wayGet communication wayGETReturns one communication way by id.
list_communication_waysList communication waysGETLists communication ways (email, phone, mobile, website) of contacts, filterable by contact, type and main flag.

Contact, 4 operations

create_contactCreate contactPOSTCreates a contact: an organisation when name is set, otherwise a person (surename, familyname). category is required; add addresses with create_contact_address and email or phone with create_communication_way.
delete_contactDelete contactDELETEDeletes a contact.
get_contactGet contactGETReturns one contact by id (in objects).
list_contactsList contactsGETLists contacts (organisations by default; depth=1 adds persons), filterable by customer number, name, city, zip and creation or update time, with limit and offset paging.

Contact address, 4 operations

create_contact_addressCreate contact addressPOSTAdds a postal address to a contact. contact, country (objectName StaticCountry, ids from list_countries) and category (objectName Category, ids from list_categories with objectType ContactAddress) are required.
delete_contact_addressDelete contact addressDELETEDeletes a contact address.
get_contact_addressGet contact addressGETReturns one contact address by id.
list_contact_addressesList contact addressesGETLists contact addresses, with limit and offset paging.

Contact custom field, 4 operations

create_contact_custom_fieldCreate contact custom fieldPOSTSets a custom field value on a contact: the contact, the field setting (from list_custom_field_settings) and the value.
delete_contact_custom_fieldDelete contact custom fieldDELETEDeletes a custom field value from a contact.
get_contact_custom_fieldGet contact custom fieldGETReturns one contact custom field value by id.
list_contact_custom_fieldsList contact custom fieldsGETLists the custom field values set on contacts, with limit and offset paging.

Contact custom field setting, 4 operations

create_custom_field_settingCreate custom field settingPOSTDefines a new custom field for contacts.
delete_custom_field_settingDelete custom field settingDELETEDeletes a custom field definition.
get_custom_field_settingGet custom field settingGETReturns one custom field definition by id.
list_custom_field_settingsList custom field settingsGETLists the custom field definitions (name, identifier, description) available on contacts.

Enshrine, 4 operations

enshrine_credit_noteEnshrine credit notePUTEnshrines (locks) an open or later credit note so it can never be changed again. Cannot be undone.
enshrine_invoiceEnshrine invoicePUTEnshrines (locks) an open or later invoice so it can never be changed again. Cannot be undone.
enshrine_transactionEnshrine transactionPUTEnshrines (locks) a linked or booked transaction (status 200 or higher) so it can never be changed again. Cannot be undone.
enshrine_voucherEnshrine voucherPUTEnshrines (locks) an open or later voucher so it can never be changed again. Cannot be undone.

Book amount, 3 operations

book_credit_noteBook credit notePUTBooks a payment against a credit note on a check account, fully or partially, optionally linking an existing bank transaction.
book_invoiceBook invoicePUTBooks a payment against an invoice on a check account, fully or partially (type FULL_PAYMENT, N, CB, O, OF, MTC), optionally linking an existing bank transaction.
book_voucherBook voucherPUTBooks a payment against a voucher on a check account, fully or partially, optionally linking an existing bank transaction.

Check account, 3 operations

delete_check_accountDelete check accountDELETEDeletes a check account.
get_check_accountGet check accountGETReturns one check account by id.
list_check_accountsList check accountsGETLists check accounts: bank accounts, clearing accounts, cash registers and file import accounts.

Credit note, 3 operations

delete_credit_noteDelete credit noteDELETEDeletes a credit note.
get_credit_noteGet credit noteGETReturns one credit note by id (in objects).
list_credit_notesList credit notesGETLists credit notes, filterable by status, number, contact and date range, with limit and offset paging.

Get pdf, 3 operations

get_credit_note_pdfGet credit note pdfGETReturns the credit note PDF as base64 content with its file name. Set preventSendBy=true so fetching it does not also mark it as sent.
get_invoice_pdfGet invoice pdfGETReturns the invoice PDF as base64 content with its file name. Set preventSendBy=true so fetching it does not also mark the invoice as sent.
get_order_pdfGet order pdfGETReturns the order PDF as base64 content with its file name. Set preventSendBy=true so fetching it does not also mark the order as sent.

Order, 3 operations

delete_orderDelete orderDELETEDeletes an order.
get_orderGet orderGETReturns one order by id (in objects).
list_ordersList ordersGETLists orders (estimates, order confirmations, delivery notes), filterable by status, number, contact, date range and type, with limit and offset paging.

Order po, 3 operations

delete_order_positionDelete order positionDELETEDeletes an order position.
get_order_positionGet order positionGETReturns one order position by id.
list_order_positionsList order positionsGETLists order positions (line items), filterable by order, with limit and offset paging.

Part, 3 operations

create_partCreate partPOSTCreates a part (product or service) with number, name, unit, prices, tax rate and stock.
get_partGet partGETReturns one part by id.
list_partsList partsGETLists parts (products and services in the inventory), filterable by part number and name, with limit and offset paging.

Private transaction rule, 3 operations

create_private_transaction_ruleCreate private transaction rulePOSTCreates a rule that marks bank transactions as private when their payment purpose or counterpart name matches.
delete_private_transaction_ruleDelete private transaction ruleDELETEDeletes a private transaction rule.
list_private_transaction_rulesList private transaction rulesGETLists the rules that automatically mark matching bank transactions as private.

Reset to draft, 3 operations

reset_credit_note_to_draftReset credit note to draftPUTResets an open credit note (status 200) to draft (status 100). For a later status, call reset_credit_note_to_open first.
reset_invoice_to_draftReset invoice to draftPUTResets an open invoice (status 200) to draft (status 100). For a later status, call reset_invoice_to_open first.
reset_voucher_to_draftReset voucher to draftPUTResets a voucher to draft (status 50), unlinking payments. Not possible when the voucher is enshrined.

Reset to open, 3 operations

reset_credit_note_to_openReset credit note to openPUTResets a credit note to open (status 200), unlinking its transactions. Not possible when it or one of its transactions is enshrined.
reset_invoice_to_openReset invoice to openPUTResets an invoice to open (status 200), unlinking its transactions. Not possible when the invoice or one of its transactions is enshrined.
reset_voucher_to_openReset voucher to openPUTResets a voucher to open (status 100), unlinking payments. Not possible when the voucher is enshrined.

Send by, 3 operations

mark_credit_note_sentMark credit note sentPUTMarks a credit note as sent by print, post, email or PDF download without sending anything; sendDraft=true only creates an internal draft.
mark_invoice_sentMark invoice sentPUTMarks an invoice as sent by print, post, email or PDF download without sending anything; sendDraft=true only creates an internal draft.
mark_order_sentMark order sentPUTMarks an order as sent by print, post, email or PDF download without sending anything; sendDraft=true only creates an internal draft.

Tag, 3 operations

delete_tagDelete tagDELETEDeletes a tag.
get_tagGet tagGETReturns one tag by id.
list_tagsList tagsGETLists tags, filterable by id or name.

Get position, 2 operations

get_invoice_positionsGet invoice positionsGETReturns the positions (line items) of an invoice.
get_order_positionsGet order positionsGETReturns the positions (line items) of an order.

Invoice, 2 operations

get_invoiceGet invoiceGETReturns one invoice by id (in objects); embed=contact returns the contact in full.
list_invoicesList invoicesGETLists invoices, filterable by status (100 draft, 200 open, 750 partially paid, 1000 paid), number, contact, date range, type, due or partially paid, with limit and offset paging.

Voucher, 2 operations

get_voucherGet voucherGETReturns one voucher by id (in objects).
list_vouchersList vouchersGETLists vouchers (receipts), filterable by status, credit or debit, description, supplier, contact, date range, year and month, with limit and offset paging.

Bookkeeping system version, 1 operation

get_bookkeeping_system_versionGet bookkeeping system versionGETTells whether the account runs sevdesk-Update 1.0 or 2.0, which decides how taxes are given (taxType and taxSet on 1.0, taxRule on 2.0).

Cancel invoice, 1 operation

cancel_invoiceCancel invoicePOSTCancels an invoice by creating a cancellation invoice, which is marked paid; the original invoice's status changes to cancelled.

Categories, 1 operation

list_categoriesList categoriesGETLists sevdesk categories for one object type (Contact, ContactAddress, Part...), whose ids create_contact, create_contact_address and create_part take as category.

Check customer number availability, 1 operation

check_customer_number_availabilityCheck customer number availabilityGETChecks whether a customer number is still free (objects is true) or already used by a contact.

Clearing account, 1 operation

create_clearing_accountCreate clearing accountPOSTCreates a clearing account.

Communication way key, 1 operation

list_communication_way_keysList communication way keysGETLists the communication way keys (labels such as private, work, fax), whose ids create_communication_way takes as key.

Contact list csv, 1 operation

export_contacts_csvExport contacts csvGETExports contacts as a CSV file, returned base64-encoded in objects.content. sevQuery selects them (modelName Contact, objectName SevQuery, optional limit and filter).

Countries, 1 operation

list_countriesList countriesGETLists the countries sevdesk knows (StaticCountry), whose ids contact addresses and documents take as country or addressCountry.

Create, 1 operation

create_tagCreate tagPOSTCreates a tag with a name and attaches it to one invoice, order, voucher or credit note; the tag relation is created with it.

Create contract note from order, 1 operation

create_contract_note_from_orderCreate contract note from orderPOSTCreates an order confirmation (contract note) from an order.

Create from invoice, 1 operation

create_credit_note_from_invoiceCreate credit note from invoicePOSTCreates a credit note from an existing invoice.

Create from voucher, 1 operation

create_credit_note_from_voucherCreate credit note from voucherPOSTCreates a credit note from a voucher. Not supported on accounts on sevdesk-Update 2.0 (see get_bookkeeping_system_version).

Create invoice from order, 1 operation

create_invoice_from_orderCreate invoice from orderPOSTCreates an invoice from an order: the full order, or a partial (TR) or advance (AR) invoice for a percentage, net or gross amount.

Create invoice reminder, 1 operation

create_invoice_reminderCreate invoice reminderPOSTCreates a payment reminder (dunning invoice, type MA) for an unpaid invoice.

Create packing list from order, 1 operation

create_packing_list_from_orderCreate packing list from orderPOSTCreates a delivery note (packing list) from an order.

Credit note csv, 1 operation

export_credit_notes_csvExport credit notes csvGETExports credit notes as a CSV file, returned base64-encoded in objects.content. sevQuery selects them (modelName CreditNote, objectName SevQuery, optional limit and filter).

Credit note po, 1 operation

list_credit_note_positionsList credit note positionsGETLists credit note positions (line items), filterable by credit note, with limit and offset paging.

Fetch dictionary entries by type, 1 operation

list_placeholdersList placeholdersGETLists the text placeholders available for a document type (objectName, for example Invoice), usable in email subjects and texts.

File import account, 1 operation

create_file_import_accountCreate file import accountPOSTCreates a bank account fed by file imports (CSV or MT940).

Find contacts by custom field value, 1 operation

find_contacts_by_custom_fieldFind contacts by custom fieldGETFinds the contacts whose custom field (by customFieldName, or by customFieldSetting id) holds the given value.

For account number, 1 operation

get_receipt_guidance_for_accountGet receipt guidance for accountGETReturns the guidance (allowed tax rules and receipt types) for one account number.

For all account, 1 operation

list_receipt_guidanceList receipt guidanceGETLists every account usable on vouchers, each with its allowed tax rules (and their tax rates) and receipt types, to pick a valid combination when creating a voucher.

For expense, 1 operation

list_expense_receipt_guidanceList expense receipt guidanceGETLists every account, tax rule and tax rate combination usable on expense vouchers.

For revenue, 1 operation

list_revenue_receipt_guidanceList revenue receipt guidanceGETLists every account, tax rule and tax rate combination usable on revenue vouchers.

For tax rule, 1 operation

get_receipt_guidance_for_tax_ruleGet receipt guidance for tax ruleGETReturns the accounts usable with one tax rule (for example USTPFL_UMS_EINN).

Generate download hash, 1 operation

get_export_progress_hashGet export progress hashGETReturns the hash that get_export_progress takes, for an export job id.

Get balance at date, 1 operation

get_check_account_balanceGet check account balanceGETReturns a check account's balance at a date: the sum of all transactions sevdesk knows up to that day, which may differ from the real bank balance.

Get discount, 1 operation

get_order_discountsGet order discountsGETReturns the discounts of an order.

Get is partially paid, 1 operation

is_invoice_partially_paidIs invoice partially paidGETTells whether an invoice is partially paid (objects is true); a fully paid invoice answers false.

Get next customer number, 1 operation

get_next_customer_numberGet next customer numberGETReturns the next free customer number for a new contact (objects is the number as text).

Get progress, 1 operation

get_export_progressGet export progressGETReturns the progress of an export job, identified by the hash from get_export_progress_hash; poll it every few seconds until it is done.

Get reference count, 1 operation

count_custom_field_setting_referencesCount custom field setting referencesGETCounts how many contacts use a custom field definition (objects is the count).

Get related object, 1 operation

get_order_related_objectsGet order related objectsGETReturns the documents related to an order, such as invoices or delivery notes created from it.

Get stock, 1 operation

get_part_stockGet part stockGETReturns the current stock amount of a part (objects is the amount).

Get tabs item count, 1 operation

count_contact_documentsCount contact documentsGETCounts the orders, invoices, credit notes, documents, persons, vouchers, letters, parts and invoice positions linked to a contact.

Get xml, 1 operation

get_invoice_xmlGet invoice xmlGETReturns the XML of an e-invoice as text (in objects).

Invoice csv, 1 operation

export_invoices_csvExport invoices csvGETExports invoices as a CSV file, returned base64-encoded in objects.content. sevQuery selects them (modelName Invoice, objectName SevQuery, optional limit and filter).

Invoice po, 1 operation

list_invoice_positionsList invoice positionsGETLists invoice positions (line items), filterable by invoice or part, with limit and offset paging.

Job download info, 1 operation

get_export_download_infoGet export download infoGETReturns the download link of a finished export job.

Save credit note, 1 operation

save_credit_noteSave credit notePOSTCreates a credit note with its positions and discounts in one call; with creditNote.id set, it adds, updates or deletes positions of that existing credit note.

Save invoice, 1 operation

save_invoiceSave invoicePOSTCreates an invoice with its positions and discounts in one call; with invoice.id set, it adds, updates or deletes positions of that existing invoice. Copy contactPerson ({id, objectName: SevUser}) from an existing invoice or order.

Save order, 1 operation

save_orderSave orderPOSTCreates an order (estimate AN, order confirmation AB or delivery note LI), optionally with its positions, in one call.

Tag relation, 1 operation

list_tag_relationsList tag relationsGETLists tag relations: which tag is attached to which document.

Transactions csv, 1 operation

export_transactions_csvExport transactions csvGETExports check account transactions as a CSV file, returned base64-encoded in objects.content. sevQuery selects them (modelName CheckAccountTransaction, objectName SevQuery).

Voucher list csv, 1 operation

export_vouchers_csvExport vouchers csvGETExports vouchers as a CSV file, returned base64-encoded in objects.content. sevQuery selects them (modelName Voucher, objectName SevQuery, optional limit and filter).

Voucher po, 1 operation

list_voucher_positionsList voucher positionsGETLists voucher positions, filterable by voucher, with limit and offset paging.

Showing the first 120 of 140 endpoints. The rest are in the product, searchable from the workflow builder and from chat.

Use sevdesk from Claude Code, Cursor or Codex

Connect sevdesk in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its sevdesk operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect sevdesk

Create your workspace
Sign up free. Nothing to install.
Connect sevdesk once
Add your sevdesk connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.