BuchPilot MCP – sevDesk & Lexoffice for n8n/AI

by makririch

431 downloads
Not rated
GitHub

About

MCP server for DACH accounting automation. Connect AI assistants to sevDesk and Lexoffice — create invoices, manage contacts, handle bookings and vouchers. Designed for German-speaking businesses using cloud accounting software.

Details

Author
makririch
Downloads
431
Categories
Other

- 15 tools for contacts, invoices, vouchers, quotations
- Overdue invoice analysis with amounts and days overdue
- Plugin support for e-invoice (XRechnung, ZUGFeRD) via einvoice-mcp
- No database or state – pure API

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name BuchPilot MCP – sevDesk & Lexoffice for n8n/AI
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install via npm globally (npm install -g buchpilot-mcp) or from source. Configure with a .buchpilot.json file containing a Lexoffice API key. Start the server standalone (buchpilot-mcp or npm start) or integrate with Claude Desktop by adding it to claude_desktop_config.json. Then issue natural language commands like “Create an invoice for contact XYZ” or “Show all overdue invoices.”

create_contact

Erstellt einen neuen Kontakt (Person oder Firma) im Buchhaltungssystem. Creates a new contact (person or company).

get_contact

Ruft einen Kontakt per ID ab. Gets a contact by ID.

list_contacts

Listet Kontakte auf mit optionalen Filtern. Lists contacts with optional filters.

update_contact

Aktualisiert einen bestehenden Kontakt. Updates an existing contact.

create_invoice

Erstellt eine neue Rechnung mit Positionen. Creates a new invoice with line items.

get_invoice

Ruft eine Rechnung per ID ab. Gets an invoice by ID.

list_invoices

Listet Rechnungen auf. Kann nach Status filtern (draft, open, paid, overdue). Lists invoices with optional status filter.

get_invoice_pdf

Laedt eine Rechnung als PDF herunter (Base64-kodiert). Downloads an invoice as PDF (base64-encoded).

update_invoice

Aktualisiert eine bestehende Rechnung (nur Entwuerfe). Updates a draft invoice.

create_voucher

Erstellt einen neuen Beleg (Eingangsrechnung, Gutschrift). Creates a new voucher (purchase invoice, credit note).

get_voucher

Ruft einen Beleg per ID ab. Gets a voucher by ID.

list_vouchers

Listet Belege auf mit optionalen Filtern. Lists vouchers with optional filters.

create_quotation

Erstellt ein neues Angebot mit Positionen. Creates a new quotation with line items.

get_quotation

Ruft ein Angebot per ID ab. Gets a quotation by ID.

get_overdue_invoices

Listet alle ueberfaelligen Rechnungen mit Betrag und Faelligkeitsdatum. Lists all overdue invoices with amount and due date.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "buchpilot mcp \u2013 sevdesk & lexoffice for n8n/ai": {
            "buchpilot": {
                "command": "npx",
                "args": [
                    "buchpilot-mcp"
                ]
            }
        }
    }
}

McpServers

{
    "buchpilot": {
        "command": "npx",
        "args": [
            "buchpilot-mcp"
        ]
    }
}

BuchPilot MCP Server

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

npm version
License: MIT

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)

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.