Buchpilot MCP server

BuchPilot MCP Server

MCP Server fuer DACH-Buchhaltung — Kontakte, Rechnungen, Belege und Angebote direkt aus Claude, Cursor oder jedem MCP-kompatiblen Client verwalten.

Was ist das?

BuchPilot MCP ist ein Model Context Protocol Server, der dein Buchhaltungssystem (aktuell Lexoffice) mit KI-Assistenten verbindet. Du kannst per natuerlicher Sprache Rechnungen erstellen, Kontakte verwalten und ueberfaellige Zahlungen pruefen — direkt in Claude Desktop, Cursor oder jedem anderen MCP-Client.

Features

• 15 Tools fuer vollstaendige Buchhaltungs-Automatisierung
• Kontakte erstellen, abrufen, auflisten, aktualisieren
• Rechnungen erstellen, abrufen, auflisten, aktualisieren, PDF herunterladen
• Belege erstellen, abrufen, auflisten (Eingangsrechnungen, Gutschriften)
• Angebote erstellen, abrufen
• Ueberfaellige Rechnungen mit Betraegen und Tagen ueberfaellig
• Backend-Architektur — aktuell Lexoffice, erweiterbar fuer sevDesk, Billomat etc.
• Plugin-faehig — kann E-Invoice MCP Tools integrieren (einvoice-mcp)
• Keine Datenbank, kein State — reiner API-Proxy

Installation

Voraussetzungen

• Node.js >= 18
• Ein Lexoffice-Account mit API-Key

npm (global)

npm install -g buchpilot-mcp

Von Source

git clone https://github.com/makririch/buchpilot-mcp.git
cd buchpilot-mcp
npm install
npm run build

Konfiguration

Erstelle eine Konfigurationsdatei .buchpilot.json an einem der folgenden Orte:

1. Pfad aus Umgebungsvariable BUCHPILOT_CONFIG
2. ~/.buchpilot.json (Home-Verzeichnis)
3. ./.buchpilot.json (aktuelles Verzeichnis)

Inhalt der .buchpilot.json

{
  "backends": {
    "lexoffice": {
      "api_key": "DEIN_LEXOFFICE_API_KEY"
    }
  },
  "default_backend": "lexoffice"
}

Lexoffice API-Key erstellen

1. Gehe zu Lexoffice Public API
2. Klicke auf API-Key erstellen
3. Kopiere den Key und fuege ihn in .buchpilot.json ein

Sicherheitshinweis: Speichere den API-Key nie in Git. Fuege .buchpilot.json zu deiner .gitignore hinzu.

Nutzung

Server starten (standalone)

# Nach npm install -g:
buchpilot-mcp

# Oder von Source:
npm start

# Entwicklung mit Auto-Reload:
npm run dev

Der Server laeuft ueber stdio und wartet auf MCP-Nachrichten.

In Claude Desktop verwenden

Siehe Claude Desktop Setup Guide fuer eine detaillierte Anleitung.

Kurzversion — fuege in claudedesktopconfig.json hinzu:

{
  "mcpServers": {
    "buchpilot": {
      "command": "npx",
      "args": ["-y", "buchpilot-mcp"],
      "env": {
        "BUCHPILOT_CONFIG": "/Users/DEIN_NAME/.buchpilot.json"
      }
    }
  }
}

Beispiele (natuerliche Sprache in Claude)

Nachdem du den Server konfiguriert hast, kannst du Claude z.B. fragen:

• "Erstelle einen Kontakt fuer die Firma Beispiel GmbH mit der E-Mail info@beispiel.de"
• "Zeige mir alle offenen Rechnungen"
• "Erstelle eine Rechnung an Kontakt XYZ: 10 Stunden Beratung zu je 150 EUR"
• "Welche Rechnungen sind ueberfaellig?"
• "Lade die PDF von Rechnung ABC herunter"
• "Erstelle ein Angebot fuer 5 Lizenzen a 49 EUR/Monat"

Tool-Referenz

Eine vollstaendige Referenz aller 15 Tools mit Parametern, Beispiel-Inputs und Beispiel-Outputs findest du in docs/tool-reference.md.

Kurzuebersicht

Shortened. The full README is on GitHub.