Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@sevdesk-mcp create a new contact for John Doe"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP Server for the sevDesk Accounting API. This server provides 52 tools for managing contacts, invoices, credit notes, orders, vouchers, transactions, and parts in sevDesk.
npm install -g @honeyfield/sevdesk-mcpOr use directly with npx:
npx @honeyfield/sevdesk-mcpRelated MCP server: sevdesk MCP Server
Set your sevDesk API token as an environment variable:
export SEVDESK_API_TOKEN=your-api-tokenLog in to your sevDesk account
Go to Settings (Einstellungen) → Users (Benutzer) → API Token
Generate a new token
Copy and store the token securely (it's only shown once)
Add to your MCP configuration:
{
"mcpServers": {
"sevdesk": {
"command": "npx",
"args": ["@honeyfield/sevdesk-mcp"],
"env": {
"SEVDESK_API_TOKEN": "your-api-token"
}
}
}
}Tool | Description |
| List contacts with filters (customers, suppliers, partners) |
| Get contact details by ID |
| Create a new contact |
| Update an existing contact |
| Delete a contact |
| Generate the next customer number |
| List addresses for a contact |
| Create a new contact address |
Tool | Description |
| List invoices with filters |
| Get invoice details by ID |
| Create a new invoice with positions |
| Update an existing invoice |
| Delete an invoice |
| Send invoice via email |
| Book a payment for an invoice |
| Lock/finalize an invoice |
| Reset invoice to draft status |
| Get invoice PDF download info |
| Export invoice as XRechnung XML |
| Create invoice from an order |
Tool | Description |
| List credit notes with filters |
| Get credit note details by ID |
| Create a new credit note |
| Update an existing credit note |
| Delete a credit note |
| Send credit note via email |
| Book a payment for a credit note |
| Lock/finalize a credit note |
| Create credit note from an invoice |
Tool | Description |
| List orders/quotes with filters |
| Get order details by ID |
| Create a new order/quote |
| Update an existing order |
| Delete an order |
| Send order via email |
Tool | Description |
| List vouchers/receipts with filters |
| Get voucher details by ID |
| Create a new voucher |
| Update an existing voucher |
| Book a payment for a voucher |
Tool | Description |
| List payment accounts |
| List transactions with filters |
| Get transaction details by ID |
| Create a new transaction |
| Update an existing transaction |
Tool | Description |
| List parts/articles with filters |
| Get part details by ID |
| Create a new part/article |
| Update an existing part |
Tool | Description |
| Get sevDesk system version |
| Get next document number |
| Export data of a specific type |
Invoices/Credit Notes:
100 - Draft
200 - Open/Delivered
1000 - Paid
Orders:
100 - Draft
200 - Delivered
300 - Accepted
500 - Partially invoiced
750 - Invoiced
1000 - Cancelled
Vouchers:
50 - Draft
100 - Unpaid
1000 - Paid
3 - Customer (Kunde)
4 - Supplier (Lieferant)
28 - Partner
AN - Quote (Angebot)
AB - Order Confirmation (Auftragsbestätigung)
LI - Delivery Note (Lieferschein)
1 - Germany
See sevDesk documentation for other countries
1 - Piece (Stück)
2 - Hour (Stunde)
See sevDesk documentation for other units
{
"name": "ACME GmbH",
"categoryId": 3,
"defaultTimeToPay": 14,
"vatNumber": "DE123456789"
}{
"contactId": 12345,
"invoiceDate": "2024-01-15",
"positions": [
{
"name": "Consulting",
"quantity": 8,
"price": 150.00,
"taxRate": 19,
"unityId": 2
}
],
"header": "Invoice for January 2024",
"timeToPay": 14
}{
"contactId": 12345,
"orderDate": "2024-01-10",
"orderType": "AN",
"positions": [
{
"name": "Web Development",
"quantity": 1,
"price": 5000.00,
"taxRate": 19,
"unityId": 1,
"optional": false
}
]
}# Install dependencies
npm install
# Build
npm run build
# Run in development
npm run devnpx @anthropic-ai/mcp-inspector dist/index.jsMIT
This server cannot be deployed
Headless API-first double-entry accounting & bookkeeping engine. 84 MCP tools over HTTP.
Query and add to your Fibalo bookkeeping: documents, bank transactions, suppliers, access.
Create and manage invoices and customers on Jupiter Invoice (MCP, API-key auth).
Access Avalara AvaTax API for tax calculation, transactions, nexus management, and compliance
