sevdesk MCP server
152 operations0 webhooks
Access sevdesk contacts, bookkeeping, invoices, orders, vouchers, exports, and related REST resources through validated JSON operations.
Try sevdesk with your agent
Connect sevdesk, then paste this into Claude, ChatGPT or Cursor. For ideas from other apps, see the use cases.
Using Corsair, show me what you can do in sevdesk on my account, then run one read-only example and show me the result.
sevdesk tools and triggers
Tools are what your agent can do in sevdesk through Corsair's MCP server. Triggers are the sevdesk events a routine can start from.
Invoice
- Book InvoiceDestructive
Book an invoice. Confirm before sending, booking, deleting, or legally enshrining accounting records.
invoice.bookInvoice
- Cancel InvoiceDestructive
Cancel an invoice / Create cancellation invoice. Confirm before sending, booking, deleting, or legally enshrining accounting records.
invoice.cancelInvoice
- Create Invoice By FactoryWrite
Create a new invoice. Changes Sevdesk data or starts an export job.
invoice.createInvoiceByFactory
- Create Invoice From OrderWrite
Create invoice from order. Changes Sevdesk data or starts an export job.
invoice.createInvoiceFromOrder
- Create Invoice ReminderDestructive
Create invoice reminder. Confirm before sending, booking, deleting, or legally enshrining accounting records.
invoice.createInvoiceReminder
- Get Invoice By IdRead-only
Find invoice by ID. Reads Sevdesk data.
invoice.getInvoiceById
- Get Invoice Positions By IdRead-only
Find invoice positions. Reads Sevdesk data.
invoice.getInvoicePositionsById
- Get InvoicesRead-only
Retrieve invoices. Reads Sevdesk data.
invoice.getInvoices
- Get Is Invoice Partially PaidRead-only
Check if an invoice is already partially paid. Reads Sevdesk data.
invoice.getIsInvoicePartiallyPaid
- Invoice EnshrineDestructive
Enshrine. Confirm before sending, booking, deleting, or legally enshrining accounting records.
invoice.invoiceEnshrine
- Invoice Get PdfDestructive
Retrieve pdf document of an invoice. Confirm before sending, booking, deleting, or legally enshrining accounting records.
invoice.invoiceGetPdf
- Invoice RenderWrite
Render the pdf document of an invoice. Changes Sevdesk data or starts an export job.
invoice.invoiceRender
- Invoice Reset To DraftWrite
Reset status to draft. Changes Sevdesk data or starts an export job.
invoice.invoiceResetToDraft
- Invoice Reset To OpenWrite
Reset status to open. Changes Sevdesk data or starts an export job.
invoice.invoiceResetToOpen
- Invoice Send ByDestructive
Mark invoice as sent. Confirm before sending, booking, deleting, or legally enshrining accounting records.
invoice.invoiceSendBy
- Send Invoice Via EMailDestructive
Send invoice via email. Confirm before sending, booking, deleting, or legally enshrining accounting records.
invoice.sendInvoiceViaEMail
Credit Note
- Book Credit NoteDestructive
Book a credit note. Confirm before sending, booking, deleting, or legally enshrining accounting records.
creditNote.bookCreditNote
- Create Credit Note From InvoiceWrite
Creates a new creditNote from an invoice. Changes Sevdesk data or starts an export job.
creditNote.createCreditNoteFromInvoice
- Create Credit Note From VoucherWrite
Creates a new creditNote from a voucher. Changes Sevdesk data or starts an export job.
creditNote.createCreditNoteFromVoucher
- Createcredit NoteWrite
Create a new creditNote. Changes Sevdesk data or starts an export job.
creditNote.createcreditNote
- Credit Note EnshrineDestructive
Enshrine. Confirm before sending, booking, deleting, or legally enshrining accounting records.
creditNote.creditNoteEnshrine
- Credit Note Get PdfDestructive
Retrieve pdf document of a credit note. Confirm before sending, booking, deleting, or legally enshrining accounting records.
creditNote.creditNoteGetPdf
- Credit Note Reset To DraftWrite
Reset status to draft. Changes Sevdesk data or starts an export job.
creditNote.creditNoteResetToDraft
- Credit Note Reset To OpenWrite
Reset status to open. Changes Sevdesk data or starts an export job.
creditNote.creditNoteResetToOpen
- Credit Note Send ByDestructive
Mark credit note as sent. Confirm before sending, booking, deleting, or legally enshrining accounting records.
creditNote.creditNoteSendBy
- Deletecredit NoteDestructive
Deletes an creditNote. Confirm before sending, booking, deleting, or legally enshrining accounting records.
creditNote.deletecreditNote
- Get Credit NotesRead-only
Retrieve CreditNote. Reads Sevdesk data.
creditNote.getCreditNotes
- Getcredit Note By IdRead-only
Find creditNote by ID. Reads Sevdesk data.
creditNote.getcreditNoteById
- Send Credit Note By PrintingDestructive
Send credit note by printing. Confirm before sending, booking, deleting, or legally enshrining accounting records.
creditNote.sendCreditNoteByPrinting
- Send Credit Note Via EMailDestructive
Send credit note via email. Confirm before sending, booking, deleting, or legally enshrining accounting records.
creditNote.sendCreditNoteViaEMail
- Updatecredit NoteWrite
Update an existing creditNote. Changes Sevdesk data or starts an export job.
creditNote.updatecreditNote
Export
- Export ContactRead-only
Export contact. Reads Sevdesk data.
export.exportContact
- Export Credit NoteRead-only
Export creditNote. Reads Sevdesk data.
export.exportCreditNote
- Export Datev CSVDestructive
Start DATEV CSV ZIP export. With enshrineDocuments: true it enshrines the exported documents, which cannot be undone (GoBD).
export.exportDatevCSV
- Export Datev DepricatedDestructive
Export datev. With enshrine: true it enshrines the exported documents, which cannot be undone (GoBD).
export.exportDatevDepricated
- Export Datev XMLRead-only
Start DATEV XML ZIP export. Reads Sevdesk data.
export.exportDatevXML
- Export InvoiceRead-only
Export invoice. Reads Sevdesk data.
export.exportInvoice
- Export Invoice ZipRead-only
Export Invoice as zip. Reads Sevdesk data.
export.exportInvoiceZip
- Export TransactionsRead-only
Export transaction. Reads Sevdesk data.
export.exportTransactions
- Export VoucherRead-only
Export voucher as zip. Reads Sevdesk data.
export.exportVoucher
- Export Voucher ZipRead-only
Export voucher zip. Reads Sevdesk data.
export.exportVoucherZip
- Generate Download HashWrite
Generate download hash. Changes Sevdesk data or starts an export job.
export.generateDownloadHash
- Get ProgressRead-only
Get progress. Reads Sevdesk data.
export.getProgress
- Job Download InfoRead-only
Get job download info. Reads Sevdesk data.
export.jobDownloadInfo
- Update Export ConfigWrite
Update export config. Changes Sevdesk data or starts an export job.
export.updateExportConfig
Order
- Create Contract Note From OrderWrite
Create contract note from order. Changes Sevdesk data or starts an export job.
order.createContractNoteFromOrder
- Create OrderWrite
Create a new order. Changes Sevdesk data or starts an export job.
order.createOrder
- Create Packing List From OrderWrite
Create packing list from order. Changes Sevdesk data or starts an export job.
order.createPackingListFromOrder
- Delete OrderDestructive
Deletes an order. Confirm before sending, booking, deleting, or legally enshrining accounting records.
order.deleteOrder
- Get DiscountsRead-only
Find order discounts. Reads Sevdesk data.
order.getDiscounts
- Get Order By IdRead-only
Find order by ID. Reads Sevdesk data.
order.getOrderById
- Get Order Positions By IdRead-only
Find order positions. Reads Sevdesk data.
order.getOrderPositionsById
- Get OrdersRead-only
Retrieve orders. Reads Sevdesk data.
order.getOrders
- Get Related ObjectsRead-only
Find related objects. Reads Sevdesk data.
order.getRelatedObjects
- Order Get PdfDestructive
Retrieve pdf document of an order. Confirm before sending, booking, deleting, or legally enshrining accounting records.
order.orderGetPdf
- Order Send ByDestructive
Mark order as sent. Confirm before sending, booking, deleting, or legally enshrining accounting records.
order.orderSendBy
- Sendorder Via EMailDestructive
Send order via email. Confirm before sending, booking, deleting, or legally enshrining accounting records.
order.sendorderViaEMail
- Update OrderWrite
Update an existing order. Changes Sevdesk data or starts an export job.
order.updateOrder
Voucher
- Book VoucherDestructive
Book a voucher. Confirm before sending, booking, deleting, or legally enshrining accounting records.
voucher.bookVoucher
- For Account NumberRead-only
Get guidance by account number. Reads Sevdesk data.
voucher.forAccountNumber
- For All AccountsRead-only
Get all account guides. Reads Sevdesk data.
voucher.forAllAccounts
- For ExpenseRead-only
Get guidance for expense accounts. Reads Sevdesk data.
voucher.forExpense
- For RevenueRead-only
Get guidance for revenue accounts. Reads Sevdesk data.
voucher.forRevenue
- For Tax RuleRead-only
Get guidance by Tax Rule. Reads Sevdesk data.
voucher.forTaxRule
- Get Voucher By IdRead-only
Find voucher by ID. Reads Sevdesk data.
voucher.getVoucherById
- Get VouchersRead-only
Retrieve vouchers. Reads Sevdesk data.
voucher.getVouchers
- Update VoucherWrite
Update an existing voucher. Changes Sevdesk data or starts an export job.
voucher.updateVoucher
- Voucher EnshrineDestructive
Enshrine. Confirm before sending, booking, deleting, or legally enshrining accounting records.
voucher.voucherEnshrine
- Voucher Factory Save VoucherWrite
Create a new voucher. Changes Sevdesk data or starts an export job.
voucher.voucherFactorySaveVoucher
- Voucher Reset To DraftWrite
Reset status to draft. Changes Sevdesk data or starts an export job.
voucher.voucherResetToDraft
- Voucher Reset To OpenWrite
Reset status to open. Changes Sevdesk data or starts an export job.
voucher.voucherResetToOpen
Contact Field
- Create Contact FieldWrite
Create contact field. Changes Sevdesk data or starts an export job.
contactField.createContactField
- Create Contact Field SettingWrite
Create contact field setting. Changes Sevdesk data or starts an export job.
contactField.createContactFieldSetting
- Delete Contact Custom Field IdDestructive
delete a contact field. Confirm before sending, booking, deleting, or legally enshrining accounting records.
contactField.deleteContactCustomFieldId
- Delete Contact Field SettingDestructive
Deletes a contact field setting. Confirm before sending, booking, deleting, or legally enshrining accounting records.
contactField.deleteContactFieldSetting
- Get Contact Field Setting By IdRead-only
Find contact field setting by ID. Reads Sevdesk data.
contactField.getContactFieldSettingById
- Get Contact Field SettingsRead-only
Retrieve contact field settings. Reads Sevdesk data.
contactField.getContactFieldSettings
- Get Contact FieldsRead-only
Retrieve contact fields. Reads Sevdesk data.
contactField.getContactFields
- Get Contact Fields By IdRead-only
Retrieve contact fields. Reads Sevdesk data.
contactField.getContactFieldsById
- Get PlaceholderRead-only
Retrieve Placeholders. Reads Sevdesk data.
contactField.getPlaceholder
- Get Reference CountRead-only
Receive count reference. Reads Sevdesk data.
contactField.getReferenceCount
- Update Contact Field SettingWrite
Update contact field setting. Changes Sevdesk data or starts an export job.
contactField.updateContactFieldSetting
- Update ContactfieldWrite
Update a contact field. Changes Sevdesk data or starts an export job.
contactField.updateContactfield
Contact
- Contact Customer Number Availability CheckRead-only
Check if a customer number is available. Reads Sevdesk data.
contact.contactCustomerNumberAvailabilityCheck
- Create ContactWrite
Create a new contact. Changes Sevdesk data or starts an export job.
contact.createContact
- Delete ContactDestructive
Deletes a contact. Confirm before sending, booking, deleting, or legally enshrining accounting records.
contact.deleteContact
- Find Contacts By Custom Field ValueRead-only
Find contacts by custom field value. Reads Sevdesk data.
contact.findContactsByCustomFieldValue
- Get Contact By IdRead-only
Find contact by ID. Reads Sevdesk data.
contact.getContactById
- Get Contact Tabs Item Count By IdRead-only
Get number of all items. Reads Sevdesk data.
contact.getContactTabsItemCountById
- Get ContactsRead-only
Retrieve contacts. Reads Sevdesk data.
contact.getContacts
- Get Next Customer NumberRead-only
Get next free customer number. Reads Sevdesk data.
contact.getNextCustomerNumber
- Update ContactWrite
Update a existing contact. Changes Sevdesk data or starts an export job.
contact.updateContact
Check Account
- Create Clearing AccountWrite
Create a new clearing account. Changes Sevdesk data or starts an export job.
checkAccount.createClearingAccount
- Create File Import AccountWrite
Create a new file import account. Changes Sevdesk data or starts an export job.
checkAccount.createFileImportAccount
- Delete Check AccountDestructive
Deletes a check account. Confirm before sending, booking, deleting, or legally enshrining accounting records.
checkAccount.deleteCheckAccount
- Get Balance At DateRead-only
Get the balance at a given date. Reads Sevdesk data.
checkAccount.getBalanceAtDate
- Get Check Account By IdRead-only
Find check account by ID. Reads Sevdesk data.
checkAccount.getCheckAccountById
- Get Check AccountsRead-only
Retrieve check accounts. Reads Sevdesk data.
checkAccount.getCheckAccounts
- Update Check AccountWrite
Update an existing check account. Changes Sevdesk data or starts an export job.
checkAccount.updateCheckAccount
Check Account Transaction
- Check Account Transaction EnshrineDestructive
Enshrine. Confirm before sending, booking, deleting, or legally enshrining accounting records.
checkAccountTransaction.checkAccountTransactionEnshrine
- Create TransactionWrite
Create a new transaction. Changes Sevdesk data or starts an export job.
checkAccountTransaction.createTransaction
- Delete Check Account TransactionDestructive
Deletes a check account transaction. Confirm before sending, booking, deleting, or legally enshrining accounting records.
checkAccountTransaction.deleteCheckAccountTransaction
- Get Check Account Transaction By IdRead-only
Find check account transaction by ID. Reads Sevdesk data.
checkAccountTransaction.getCheckAccountTransactionById
- Get TransactionsRead-only
Retrieve transactions. Reads Sevdesk data.
checkAccountTransaction.getTransactions
- Update Check Account TransactionWrite
Update an existing check account transaction. Changes Sevdesk data or starts an export job.
checkAccountTransaction.updateCheckAccountTransaction
Communication Way
- Create Communication WayWrite
Create a new contact communication way. Changes Sevdesk data or starts an export job.
communicationWay.createCommunicationWay
- Delete Communication WayDestructive
Deletes a communication way. Confirm before sending, booking, deleting, or legally enshrining accounting records.
communicationWay.deleteCommunicationWay
- Get Communication Way By IdRead-only
Find communication way by ID. Reads Sevdesk data.
communicationWay.getCommunicationWayById
- Get Communication Way KeysRead-only
Retrieve communication way keys. Reads Sevdesk data.
communicationWay.getCommunicationWayKeys
- Get Communication WaysRead-only
Retrieve communication ways. Reads Sevdesk data.
communicationWay.getCommunicationWays
- Update Communication WayWrite
Update a existing communication way. Changes Sevdesk data or starts an export job.
communicationWay.updateCommunicationWay
Tag
- Create TagWrite
Create a new tag. Changes Sevdesk data or starts an export job.
tag.createTag
- Delete TagDestructive
Deletes a tag. Confirm before sending, booking, deleting, or legally enshrining accounting records.
tag.deleteTag
- Get Tag By IdRead-only
Find tag by ID. Reads Sevdesk data.
tag.getTagById
- Get Tag RelationsRead-only
Retrieve tag relations. Reads Sevdesk data.
tag.getTagRelations
- Get TagsRead-only
Retrieve tags. Reads Sevdesk data.
tag.getTags
- Update TagWrite
Update tag. Changes Sevdesk data or starts an export job.
tag.updateTag
Accounting Contact
- Create Accounting ContactWrite
Create a new accounting contact. Changes Sevdesk data or starts an export job.
accountingContact.createAccountingContact
- Delete Accounting ContactDestructive
Deletes an accounting contact. Confirm before sending, booking, deleting, or legally enshrining accounting records.
accountingContact.deleteAccountingContact
- Get Accounting ContactRead-only
Retrieve accounting contact. Reads Sevdesk data.
accountingContact.getAccountingContact
- Get Accounting Contact By IdRead-only
Find accounting contact by ID. Reads Sevdesk data.
accountingContact.getAccountingContactById
- Update Accounting ContactWrite
Update an existing accounting contact. Changes Sevdesk data or starts an export job.
accountingContact.updateAccountingContact
Contact Address
- Contact Address IdRead-only
Find contact address by ID. Reads Sevdesk data.
contactAddress.contactAddressId
- Create Contact AddressWrite
Create a new contact address. Changes Sevdesk data or starts an export job.
contactAddress.createContactAddress
- Delete Contact AddressDestructive
Deletes a contact address. Confirm before sending, booking, deleting, or legally enshrining accounting records.
contactAddress.deleteContactAddress
- Get Contact AddressesRead-only
Retrieve contact addresses. Reads Sevdesk data.
contactAddress.getContactAddresses
- Update Contact AddressWrite
update a existing contact address. Changes Sevdesk data or starts an export job.
contactAddress.updateContactAddress
Layout
- Get Letterpapers With ThumbRead-only
Retrieve letterpapers. Reads Sevdesk data.
layout.getLetterpapersWithThumb
- Get TemplatesRead-only
Retrieve templates. Reads Sevdesk data.
layout.getTemplates
- Update Credit Note TemplateWrite
Update an of credit note template. Changes Sevdesk data or starts an export job.
layout.updateCreditNoteTemplate
- Update Invoice TemplateWrite
Update an invoice template. Changes Sevdesk data or starts an export job.
layout.updateInvoiceTemplate
- Update Order TemplateWrite
Update an order template. Changes Sevdesk data or starts an export job.
layout.updateOrderTemplate
Part
- Create PartWrite
Create a new part. Changes Sevdesk data or starts an export job.
part.createPart
- Get Part By IdRead-only
Find part by ID. Reads Sevdesk data.
part.getPartById
- Get PartsRead-only
Retrieve parts. Reads Sevdesk data.
part.getParts
- Part Get StockRead-only
Get stock of a part. Reads Sevdesk data.
part.partGetStock
- Update PartWrite
Update an existing part. Changes Sevdesk data or starts an export job.
part.updatePart
Order Pos
- Delete Order PosDestructive
Deletes an order Position. Confirm before sending, booking, deleting, or legally enshrining accounting records.
orderPos.deleteOrderPos
- Get Order Position By IdRead-only
Find order position by ID. Reads Sevdesk data.
orderPos.getOrderPositionById
- Get Order PositionsRead-only
Retrieve order positions. Reads Sevdesk data.
orderPos.getOrderPositions
- Update Order PositionWrite
Update an existing order position. Changes Sevdesk data or starts an export job.
orderPos.updateOrderPosition
Report
- Report ContactRead-only
Export contact list. Reads Sevdesk data.
report.reportContact
- Report InvoiceRead-only
Export invoice list. Reads Sevdesk data.
report.reportInvoice
- Report OrderRead-only
Export order list. Reads Sevdesk data.
report.reportOrder
- Report VoucherRead-only
Export voucher list. Reads Sevdesk data.
report.reportVoucher
Private Transaction Rule
- Create Private Transaction RuleWrite
Create a new rule. Changes Sevdesk data or starts an export job.
privateTransactionRule.createPrivateTransactionRule
- Delete Private Transaction RuleDestructive
Delete the rule by id. Confirm before sending, booking, deleting, or legally enshrining accounting records.
privateTransactionRule.deletePrivateTransactionRule
- List Private Transaction RulesRead-only
List existing rules. Reads Sevdesk data.
privateTransactionRule.listPrivateTransactionRules
Basics
- Bookkeeping System VersionRead-only
Retrieve bookkeeping system version. Reads Sevdesk data.
basics.bookkeepingSystemVersion
Credit Note Pos
- Getcredit Note PositionsRead-only
Retrieve creditNote positions. Reads Sevdesk data.
creditNotePos.getcreditNotePositions
Invoice Pos
- Get Invoice PosRead-only
Retrieve InvoicePos. Reads Sevdesk data.
invoicePos.getInvoicePos
Voucher Pos
- Get Voucher PositionsRead-only
Retrieve voucher positions. Reads Sevdesk data.
voucherPos.getVoucherPositions
Connect sevdesk to Claude, ChatGPT or Cursor
- 1
Connect sevdesk in Corsair
Add your sevdesk API key once in Corsair. Corsair stores the credential encrypted and makes the sevdesk API calls for your agent, so it never goes into a prompt or a config file. Connect sevdesk
If your link lets the agent add apps, you can skip this: it gives you a sign-in link the first time it needs sevdesk. On a ChatGPT personal plan, connect sevdesk here first.
- 2
Add Corsair's MCP server to your agent
Every client uses the same address:
https://mcp.corsair.dev/mcpOpen Customize → Connectors → Add custom connector, paste the address, then select Connect.Add a custom MCP server with the address and choose OAuth. Personal plans get read tools only.Add to CursorOr add this to~/.cursor/mcp.json. Cursor opens Corsair to sign in the first time it connects.{ "mcpServers": { "corsair": { "url": "https://mcp.corsair.dev/mcp" } } }Run this, then run/mcpin Claude Code to sign in.claude mcp add --transport http corsair https://mcp.corsair.dev/mcpCodex, Gemini CLI, VS Code, Zed and other clients with OAuth sign-in work the same way. Clients without it, such as GitHub Copilot's coding agent, use a link's own address and an API key. Setup for every client
- 3
Sign in and choose what needs your approval
Your client opens Corsair to sign in. Pick a link: the apps your agent can use and a mode that decides what it may do without asking. In the default Cautious mode, sevdesk's read and write operations run right away and its 34 destructive operations wait for your approval. Strict mode asks before every write and refuses destructive operations, and Read mode allows reads only.
FAQ
Install corsair and @corsair-dev/sevdesk, add the sevdesk plugin, and connect with an API key. Then call methods like corsair.sevdesk.api.accountingContact.createAccountingContact() from your app. Corsair keeps each tenant isolated.
Yes. sevdesk requires an API key from your sevdesk account or developer dashboard. Create credentials with access that matches what you automate, then paste them into Corsair or connect through managed auth in Hub.
Yes. One Corsair client can hit sevdesk, GitHub, Notion, Stripe, and the rest. Trigger sevdesk from a webhook, push updates to Slack, or chain actions across plugins. Same tenant context across integrations, plain TypeScript.
Teams use Corsair for access sevdesk contacts, bookkeeping, invoices, orders, vouchers, exports, and related REST resources through validated JSON operations. Common builds include sync jobs, admin tooling, and agents that call sevdesk APIs from your backend.
The SDK is open source. Self-host and you pay Corsair nothing for the integration layer. Hub bills for hosted auth and execution, not per sevdesk API call. Hub has a generous free tier. For hobby projects you can probably run the whole thing on free. Paid plans start to matter with more tenants or heavier traffic.
We maintain @corsair-dev/sevdesk in the open repo. When sevdesk ships API changes, upgrade the package. Your call sites stay typed. You should not need to rewrite the integration layer each time.
No. Corsair does not read your sevdesk data or hold individual access credentials. Credentials stay in your database. API calls run on your instance. We do not store sevdesk data on your behalf.
Yes. Add https://mcp.corsair.dev/mcp as a custom connector or MCP server in Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex or any client that supports remote MCP servers with OAuth sign-in, then sign in to Corsair. On ChatGPT personal plans, custom servers currently get read tools only.
Yes. Put sevdesk on a link in Strict mode and every write waits for your approval, while destructive actions are refused. The default Cautious mode asks only before the 34 destructive sevdesk operations. You can change a link's mode at hub.corsair.dev/me.