mcp-sevdesk

Ein MCP (Model Context Protocol) Server für die sevdesk API. Ermöglicht die Integration von sevdesk-Buchhaltungsfunktionen in Claude und andere MCP-kompatible Anwendungen.

Features

• Kontakte: Erstellen, lesen, aktualisieren und löschen von Kontakten (Kunden, Lieferanten, Partner)
• Rechnungen: Auflisten, abrufen, als PDF exportieren, per E-Mail versenden, buchen und stornieren
• Belege (Voucher): Verwalten von Eingangsrechnungen und Ausgaben
• Bankkonten: Verwalten von Bankkonten und Transaktionen
• Artikel: Verwalten von Produkten und Dienstleistungen

Installation

npm install
npm run generate-types
npm run build

Konfiguration

Setze die Umgebungsvariable SEVDESK_API_TOKEN mit deinem sevdesk API-Token:

export SEVDESK_API_TOKEN="dein-32-zeichen-hex-token"

Den API-Token findest du in sevdesk unter: Einstellungen → Benutzer → API-Token

Verwendung

Als MCP-Server

Füge den Server zu deiner Claude Desktop Konfiguration hinzu (~/.config/claude/claude_desktop_config.json):

{
  "mcpServers": {
    "sevdesk": {
      "command": "node",
      "args": ["/pfad/zu/mcp-sevdesk/dist/index.js"],
      "env": {
        "SEVDESK_API_TOKEN": "dein-api-token"
      }
    }
  }
}

Direkt ausführen

SEVDESK_API_TOKEN="dein-token" npm start

Verfügbare Tools

Kontakte

Tool	Beschreibung
list_contacts	Alle Kontakte auflisten
get_contact	Einzelnen Kontakt abrufen
create_contact	Neuen Kontakt erstellen
update_contact	Kontakt aktualisieren
delete_contact	Kontakt löschen

Rechnungen

Tool	Beschreibung
list_invoices	Alle Rechnungen auflisten
get_invoice	Einzelne Rechnung abrufen
get_invoice_pdf	Rechnung als PDF abrufen
send_invoice_by_email	Rechnung per E-Mail versenden
mark_invoice_as_sent	Rechnung als versendet markieren
book_invoice	Rechnung als bezahlt buchen
cancel_invoice	Rechnung stornieren

Belege (Voucher)

Tool	Beschreibung
list_vouchers	Alle Belege auflisten
get_voucher	Einzelnen Beleg abrufen
book_voucher	Beleg als bezahlt buchen
get_voucher_positions	Belegpositionen abrufen
upload_voucher_file	Belegdatei hochladen

Bankkonten

Tool	Beschreibung
list_check_accounts	Alle Bankkonten auflisten
get_check_account	Einzelnes Bankkonto abrufen
get_check_account_balance	Kontostand abrufen
list_transactions	Transaktionen auflisten
get_transaction	Einzelne Transaktion abrufen
create_transaction	Neue Transaktion erstellen

Artikel

Tool	Beschreibung
list_parts	Alle Artikel auflisten
get_part	Einzelnen Artikel abrufen
create_part	Neuen Artikel erstellen
update_part	Artikel aktualisieren
get_part_stock	Lagerbestand abrufen

API-Referenz

Dieser Server basiert auf der offiziellen sevdesk API v1. Weitere Informationen zur API findest du in der sevdesk API-Dokumentation.

Lizenz

MIT