sevdesk-mcp

@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

Configuration

Environment Variable

Set your sevDesk API token as an environment variable:

export SEVDESK_API_TOKEN=your-api-token

Getting an API Token

1. Log in to your sevDesk account
2. Go to Settings (Einstellungen) → Users (Benutzer) → API Token
3. Generate a new token
4. 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

Links

• sevDesk API Documentation
• sevDesk Website
• GitHub Repository