sevdesk MCP Server v2.0

A comprehensive Model Context Protocol (MCP) server for integrating with the sevdesk German accounting and bookkeeping API. Features 76 tools for full CRUD operations across all major sevdesk resources.

Features

• Contact Management - Full CRUD for customers, suppliers, and partners
• Invoice Handling - Create, send, and manage sales invoices with line items
• Expense Tracking - Manage vouchers/receipts with booking and enshrinement
• Order Management - Handle offers, order confirmations, and delivery notes
• Credit Notes - Full credit note lifecycle management
• Products & Services - Manage parts catalog with stock tracking
• Bank Integration - Accounts, balances, and transaction management
• Tags & Categories - Organize records with tags
• Contact Details - Addresses and communication ways (email, phone)
• PDF Generation - Download PDFs for invoices, orders, and credit notes
• Email Sending - Send documents directly via email

Prerequisites

• Node.js 18 or higher
• pnpm (recommended) or npm
• A sevdesk account with API access

Installation

git clone https://github.com/sajadghawami/sevdesk-mcp.git
cd sevdesk-mcp

# Install dependencies (choose one)
pnpm install   # or: npm install | yarn install

# Build
pnpm build     # or: npm run build | yarn build

Configuration

Getting Your API Token

1. Log in to your sevdesk account at my.sevdesk.de
2. Navigate to Settings → Users → API Token
3. Generate or copy your API token

Claude Desktop

Add to your claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "sevdesk": {
      "command": "node",
      "args": ["/path/to/sevdesk-mcp/build/index.js"],
      "env": {
        "SEVDESK_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Claude Code

Add to .mcp.json in your project directory (project-specific) or ~/.claude/.mcp.json (global):

{
  "mcpServers": {
    "sevdesk-mcp": {
      "command": "node",
      "args": ["/path/to/sevdesk-mcp/build/index.js"],
      "env": {
        "SEVDESK_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Available Tools (76 total)

Contacts (6 tools)

Invoices (14 tools)