Skip to content

nikolausm/mcp-sevdesk

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

About

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

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors