MMCPMarkets
NM

nikolausm/mcp-sevdesk

API development
28 stars 0 forks Quality 60 Trend 33
Repository Install

MCP Server für sevdesk Buchhaltungs-API - Kontakte, Rechnungen, Belege, Bankkonten und Artikel verwalten

Overview

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. - : Erstellen, lesen, aktualisieren und löschen von Kontakten (Kunden, Lieferanten, Partner) - : Auflisten, abrufen, als PDF exportieren, per E-Mail versenden, buchen und stornieren - : Verwalten von Eingangsrechnungen und Ausgaben - : Verwalten von Bankkonten und Transaktionen - : Verwalten von Produkten und Dienstleistungen Setze die Umgebungsvariable SEVDESK_API_TOKEN mit deinem sevdesk API-Token: Den API-Token findest du in sevdesk unter: Einstellungen → Benutzer → API-Token Füge den Server zu deiner Claude Desktop Konfiguration hinzu (~/.config/claude/claude_desktop_config.json): Dieser Server basiert auf der offiziellen sevdesk API v1. Weitere Informationen zur API findest du in der sevdesk API-Dokumentation.

README

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

View this README on GitHub

Install

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

Open the repository installation guide

Configuration

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