E-Invoice MCP Server

MCP Server für E-Rechnungen im DACH-Raum — XRechnung erstellen, validieren und Daten extrahieren. Direkt aus Claude, Cursor oder jedem MCP-Client.

Was ist das?

E-Invoice MCP ist ein Model Context Protocol Server für die Erstellung und Validierung von E-Rechnungen nach dem deutschen XRechnung-Standard. Ab 2027 müssen alle Unternehmen in Deutschland E-Rechnungen versenden können — mit diesem Tool bist du vorbereitet.

Du sagst Claude einfach: "Erstelle eine Rechnung an die Beispiel GmbH für 10 Stunden Beratung" — und erhältst eine valide XRechnung als UBL 2.1 XML.

Features

• XRechnung erstellen — Valides UBL 2.1 XML aus strukturierten Daten (EN 16931 + XRechnung 3.0.2)
• E-Rechnung validieren — Syntax, Pflichtfelder und deutsche Business-Regeln (BR-DE) prüfen
• Daten extrahieren — Strukturierte Daten aus UBL- oder CII-XML lesen
• Format-Info — Nachschlagewerk für Pflichtfelder, Steuer-Kategorien, Einheiten-Codes und Fristen
• Automatische Berechnung — Netto, Brutto, Steuerbeträge werden automatisch berechnet
• Plugin-fähig — Kann standalone laufen ODER in den BuchPilot MCP Server integriert werden
• Keine externen Dienste — Alles läuft lokal, keine API-Keys nötig
• Keine nativen Abhängigkeiten — Läuft auf jedem System mit Node.js

Gesetzliche Fristen

| Datum | Was passiert | |-------|-------------| | 01.01.2025 | Alle Unternehmen müssen E-Rechnungen empfangen können | | 31.12.2026 | PDF-Rechnungen nur noch mit Empfänger-Zustimmung erlaubt | | 01.01.2027 | Unternehmen >800.000 EUR Umsatz müssen E-Rechnungen senden | | 01.01.2028 | ALLE Unternehmen müssen E-Rechnungen senden |

Fehlerhafte E-Rechnungen können zum Verlust des Vorsteuerabzugs führen (+ 6% Verzinsung).

Installation

Voraussetzungen

• Node.js >= 18

npm (global)

npm install -g einvoice-mcp

Von Source

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

Konfiguration

Dieser MCP Server benötigt keine Konfiguration. Es werden keine API-Keys oder externe Dienste benötigt — alles läuft lokal.

Nutzung

Server starten (standalone)

# Nach npm install -g:
einvoice-mcp

# Oder von Source:
npm start

# Entwicklung mit Auto-Reload:
npm run dev

Der Server läuft über stdio und wartet auf MCP-Nachrichten.

In Claude Desktop verwenden

Siehe Claude Desktop Setup Guide für eine detaillierte Anleitung.

Kurzversion — füge in claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "einvoice": {
      "command": "npx",
      "args": ["-y", "einvoice-mcp"]
    }
  }
}

Beispiele (natürliche Sprache in Claude)

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

• "Erstelle eine XRechnung an die Beispiel GmbH für 10 Stunden Beratung zu 150 EUR"
• "Ist diese XML-Datei eine gültige XRechnung?"
• "Extrahiere die Rechnungsdaten aus diesem XML"
• "Welche Pflichtfelder brauche ich für eine XRechnung?"
• "Welche Steuer-Kategorien gibt es und was bedeuten sie?"
• "Bis wann muss mein Unternehmen E-Rechnungen versenden können?"

Quickstart

Eine Schritt-für-Schritt-Anleitung "Erstelle deine erste XRechnung in 5 Minuten" findest du in docs/quickstart.md.

Tool-Referenz

Eine vollständige Referenz aller 4 Tools mit Parametern, Beispiel-Inputs und Beispiel-Outputs findest du in docs/tool-reference.md.

Kurzübersicht

| Tool | Beschreibung | |------|-------------| | create_xrechnung | XRechnung (UBL 2.1 XML) aus strukturierten Daten erstellen | | validate_invoice | E-Rechnung XML validieren (Syntax + BR-DE Business-Regeln) | | extract_data | Strukturierte Daten aus UBL- oder CII-XML extrahieren | | get_format_info | Nachschlagewerk für Formate, Pflichtfelder, Codes und Fristen |

BuchPilot-Integration

E-Invoice MCP kann als Plugin in den BuchPilot MCP Server integriert werden:

import { registerEInvoiceTools } from "einvoice-mcp";
registerEInvoiceTools(server);

Kombination: BuchPilot erstellt eine Rechnung in Lexoffice -> Daten extrahieren -> XRechnung erzeugen -> fertige E-Rechnung.

Unterstützte Standards

| Standard | Version | Status | |----------|---------|--------| | XRechnung | 3.0.2 | Erstellen + Validieren | | EN 16931 | — | Basis für XRechnung | | UBL 2.1 | — | XML-Syntax für XRechnung | | CII (Cross Industry Invoice) | — | Extrahieren (Lesen) | | ZUGFeRD / Factur-X | 2.3 | Extrahieren (Lesen), Erstellen geplant |

FAQ / Troubleshooting

"XML konnte nicht geparst werden"

• Ist das XML well-formed? (Alle Tags korrekt geschlossen?)
• Ist es tatsächlich eine UBL- oder CII-Rechnung? (Root-Element muss <Invoice> oder <CrossIndustryInvoice> sein)
• Ist das Encoding UTF-8?

Validierung zeigt Fehler "BR-DE-13: Buyer Reference ist Pflicht"

Die Käufer-Referenz (BT-10) ist in XRechnung Pflicht. Bei Rechnungen an öffentliche Auftraggeber ist das die Leitweg-ID. Bei B2B-Rechnungen kann es eine beliebige Referenz sein (z.B. Bestellnummer).

{
  "buyerReference": "04011000-12345-67"
}

Validierung zeigt Warnung "BR-DE-21: Telefonnummer empfohlen"

Das ist nur eine Warnung, kein Fehler. Die Rechnung ist trotzdem gültig. Für beste Kompatibilität solltest du aber eine Telefonnummer des Verkäufers angeben.

Welche Steuer-Kategorien gibt es?

| Code | Name | Beschreibung | Steuersätze | |------|------|-------------|-------------| | S | Standard | Normaler Steuersatz | 19%, 7% | | Z | Nullsatz | 0% (z.B. innergemeinschaftlich mit USt-Befreiung) | 0% | | E | Steuerbefreit | z.B. Kleinunternehmer nach Paragraph 19 UStG | 0% | | AE | Reverse Charge | Steuerschuldnerschaft des Empfängers (Paragraph 13b UStG) | 0% | | K | Innergemeinschaftlich | Steuerfreie innergemeinschaftliche Lieferung | 0% |

Welche Einheiten-Codes gibt es?

| Code | Name | Beschreibung | |------|------|-------------| | H87 | Stück | Einzelne Einheit (Default) | | HUR | Stunde | Arbeitsstunde | | DAY | Tag | Arbeitstag | | MON | Monat | Kalendermonat | | KGM | Kilogramm | Gewicht | | MTR | Meter | Länge | | LTR | Liter | Volumen | | MTK | Quadratmeter | Fläche | | SET | Set/Paket | Zusammenstellung | | C62 | Einheit (generisch) | Allgemeine Mengeneinheit |

Server startet, aber Claude erkennt die Tools nicht

• Prüfe ob die claude_desktop_config.json korrekt ist
• Starte Claude Desktop neu nach Konfigurationsänderungen
• Prüfe die Logs: ~/Library/Logs/Claude/mcp.log (macOS)

Lizenz

MIT — Frei nutzbar, auch kommerziell.

Autor

MaKri — GitHub