MMCPMarkets
CS

codestra/sevdesk-mcp

开发工具

本页由 AI 翻译，技术细节请以原文为准。 查看原文

6 stars 4 forks 质量 70 趋势 22
Repository Install

MCP server for sevDesk - enables AI assistants to interact with sevDesk's accounting, invoicing, and contact management API.

概览

A comprehensive Model Context Protocol (MCP) server for integrating with the sevdesk German accounting and bookkeeping API. Features for full CRUD operations across all major sevdesk resources. - - Full CRUD for customers, suppliers, and partners - - Create, send, and manage sales invoices with line items - - Manage vouchers/receipts with booking and enshrinement - - Handle offers, order confirmations, and delivery notes - - Full credit note lifecycle management - - Manage parts catalog with stock tracking - - Accounts, balances, and transaction management - - Organize records with tags - - Addresses and communication ways (email, phone) - - Download PDFs for invoices, orders, and credit notes - - Send documents directly via email - Node.js 18 or higher - pnpm (recommended) or npm - A sevdesk account with API access 1. Log in to your sevdesk account at my.sevdesk.de 2. Navigate to → → 3. Generate or copy your API token : ~/Library/Application Support/Claude/claude_desktop_config.

README

以下为原文 README 节选，完整内容请查看原文。

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)

Tool Description
list_contacts List customers, suppliers, and partners
get_contact Get detailed contact information by ID
create_contact Create a new contact
update_contact Update existing contact
delete_contact Delete a contact
get_next_customer_number Get next available customer number

Invoices (14 tools)

Tool Description
list_invoices List sales invoices with filters
get_invoice Get invoice details by ID
在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手？先看 mcpskill.org 教程 →

配置

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