sevdesk MCP Server

MCP (Model Context Protocol) server for sevdesk accounting and invoicing. Manage contacts, invoices, offers, and financial reports directly from Claude Code.

Tools

Contacts

• list_contacts -- List customers/suppliers with optional search

• get_contact -- Get detailed contact info by ID

• create_contact -- Create a new customer or supplier contact

• search_contacts -- Search contacts by name or email

Invoices

• list_invoices -- List invoices filtered by status (draft, open, paid, overdue)

• get_invoice -- Get invoice details with line items

• create_invoice -- Create an invoice with line items

• send_invoice -- Send an invoice via email

• get_open_invoices -- Get all unpaid/overdue invoices with totals

Offers

• list_offers -- List quotations/offers

• create_offer -- Create a quotation with line items

Reports

• get_revenue_summary -- Revenue summary by year with monthly breakdown

• get_tax_summary -- VAT/USt summary for tax reporting (yearly or quarterly)

• get_dashboard -- Financial dashboard KPIs (revenue, open invoices)

Setup

cd sevdesk-mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

# Configure
cp run-mcp.sh.example run-mcp.sh
chmod +x run-mcp.sh
# Edit run-mcp.sh and set your SEVDESK_API_TOKEN

Environment Variables

Claude Code Configuration

Add to ~/.mcp.json:

{
  "mcpServers": {
    "sevdesk": {
      "command": "/path/to/sevdesk-mcp/run-mcp.sh",
      "type": "stdio"
    }
  }
}

License

MIT -- see LICENSE