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.

• 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

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

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

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

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

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

# Install dependencies
pnpm install

# Build the TypeScript source
pnpm build

# Start the server
pnpm start

# Watch mode for development
pnpm dev

sevdesk-mcp/
├── src/
│   ├── index.ts           # MCP server entry + 76 tool registrations
│   ├── api.ts             # HTTP client (GET/POST/PUT/DELETE/PDF)
│   ├── types.ts           # TypeScript interfaces (20+ types)
│   └── tools/
│       ├── contacts.ts    # Contact CRUD
│       ├── invoices.ts    # Invoice CRUD + PDF/email/status/positions
│       ├── vouchers.ts    # Voucher CRUD + book/enshrine/positions
│       ├── accounts.ts    # Bank account + transaction CRUD
│       ├── orders.ts      # Order CRUD + PDF/email/positions
│       ├── creditnotes.ts # Credit note CRUD + PDF/email/positions
│       ├── parts.ts       # Part CRUD + stock
│       ├── tags.ts        # Tag + TagRelation CRUD
│       ├── addresses.ts   # Contact address CRUD
│       └── communication.ts # Communication way CRUD
├── build/                 # Compiled JavaScript output
├── package.json
└── tsconfig.json

This server integrates with the sevdesk REST API. For complete API documentation, see:

• sevdesk API Documentation
• API Base URL: https://my.sevdesk.de/api/v1

ISC