How do I use sevdesk-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. 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.

sevdesk-mcp

by Honeyfield-Org

Overview Schema Related Servers Score Discussions

TypeScript

Remote

@honeyfield/sevdesk-mcp

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.

Installation

npm install -g @honeyfield/sevdesk-mcp

Or use directly with npx:

npx @honeyfield/sevdesk-mcp

Related MCP server: sevdesk MCP Server

Configuration

Environment Variable

Set your sevDesk API token as an environment variable:

export SEVDESK_API_TOKEN=your-api-token

Getting an API Token

Log 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)

Claude Desktop / Claude Code

Add to your MCP configuration:

{
  "mcpServers": {
    "sevdesk": {
      "command": "npx",
      "args": ["@honeyfield/sevdesk-mcp"],
      "env": {
        "SEVDESK_API_TOKEN": "your-api-token"
      }
    }
  }
}

Available Tools (52)

Contacts (8 Tools)

Tool	Description
`list_contacts`	List contacts with filters (customers, suppliers, partners)
`get_contact`	Get contact details by ID
`create_contact`	Create a new contact
`update_contact`	Update an existing contact
`delete_contact`	Delete a contact
`get_next_customer_number`	Generate the next customer number
`list_contact_addresses`	List addresses for a contact
`create_contact_address`	Create a new contact address

Invoices (12 Tools)

Tool	Description
`list_invoices`	List invoices with filters
`get_invoice`	Get invoice details by ID
`create_invoice`	Create a new invoice with positions
`update_invoice`	Update an existing invoice
`delete_invoice`	Delete an invoice
`send_invoice_email`	Send invoice via email
`book_invoice_payment`	Book a payment for an invoice
`enshrine_invoice`	Lock/finalize an invoice
`reset_invoice_to_draft`	Reset invoice to draft status
`get_invoice_pdf`	Get invoice PDF download info
`export_invoice_xml`	Export invoice as XRechnung XML
`create_invoice_from_order`	Create invoice from an order

Credit Notes (9 Tools)

Tool	Description
`list_credit_notes`	List credit notes with filters
`get_credit_note`	Get credit note details by ID
`create_credit_note`	Create a new credit note
`update_credit_note`	Update an existing credit note
`delete_credit_note`	Delete a credit note
`send_credit_note_email`	Send credit note via email
`book_credit_note_payment`	Book a payment for a credit note
`enshrine_credit_note`	Lock/finalize a credit note
`create_credit_note_from_invoice`	Create credit note from an invoice

Orders (6 Tools)

Tool	Description
`list_orders`	List orders/quotes with filters
`get_order`	Get order details by ID
`create_order`	Create a new order/quote
`update_order`	Update an existing order
`delete_order`	Delete an order
`send_order_email`	Send order via email

Vouchers (5 Tools)

Tool	Description
`list_vouchers`	List vouchers/receipts with filters
`get_voucher`	Get voucher details by ID
`create_voucher`	Create a new voucher
`update_voucher`	Update an existing voucher
`book_voucher`	Book a payment for a voucher

Transactions (5 Tools)

Tool	Description
`list_check_accounts`	List payment accounts
`list_transactions`	List transactions with filters
`get_transaction`	Get transaction details by ID
`create_transaction`	Create a new transaction
`update_transaction`	Update an existing transaction

Parts/Inventory (4 Tools)

Tool	Description
`list_parts`	List parts/articles with filters
`get_part`	Get part details by ID
`create_part`	Create a new part/article
`update_part`	Update an existing part

Basics (3 Tools)

Tool	Description
`get_system_version`	Get sevDesk system version
`get_next_sequence_number`	Get next document number
`export_data`	Export data of a specific type

Common Parameters

Status Codes

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

Contact Categories

3 - Customer (Kunde)
4 - Supplier (Lieferant)
28 - Partner

Order Types

AN - Quote (Angebot)
AB - Order Confirmation (Auftragsbestätigung)
LI - Delivery Note (Lieferschein)

Country IDs

1 - Germany
See sevDesk documentation for other countries

Unity IDs

1 - Piece (Stück)
2 - Hour (Stunde)
See sevDesk documentation for other units

Examples

Create a Customer

{
  "name": "ACME GmbH",
  "categoryId": 3,
  "defaultTimeToPay": 14,
  "vatNumber": "DE123456789"
}

Create an Invoice

{
  "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
}

Create a Quote

{
  "contactId": 12345,
  "orderDate": "2024-01-10",
  "orderType": "AN",
  "positions": [
    {
      "name": "Web Development",
      "quantity": 1,
      "price": 5000.00,
      "taxRate": 19,
      "unityId": 1,
      "optional": false
    }
  ]
}

Development

# Install dependencies
npm install

# Build
npm run build

# Run in development
npm run dev

Testing with MCP Inspector

npx @anthropic-ai/mcp-inspector dist/index.js

License

MIT

Latest Blog Posts

Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly
Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
OpenAI
open source

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Honeyfield-Org/sevdesk-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server