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