Ermöglicht es AI-Clients, Kunden zu verwalten, Rechnungsentwürfe zu erstellen, Rechnungen aufzulisten und Zahlungen über die BillingEngine API zu erfassen.
Auch bekannt als billingengine/billingengine-mcp, billingengine-mcp
- Stars
- 0
- Tools
- 10
- Downloads, 30 Tage
- 841
- Neueste Version
- 0.2.2
- Letzter Commit
- 6. Nov. 2026
- Lizenz
- MIT
Was ist BillingEngine MCP?
BillingEngine ist ein MCP server. Ermöglicht es AI-Clients, Kunden zu verwalten, Rechnungsentwürfe zu erstellen, Rechnungen aufzulisten und Zahlungen über die BillingEngine API zu erfassen. Er stellt 10 Tools bereit, etwa find_customers, create_customer, update_customer.
Zusammenfassung generiert aus dem README des Projekts
Über BillingEngine MCP server
Freelancer und Kleinunternehmer können mit diesem Server Kundendaten und Finanzdokumente über eine AI-Schnittstelle verwalten. Durch die Verbindung zur BillingEngine API können Nutzer über Clients wie Claude Desktop, Cursor oder Claude Code mittels natürlicher Sprache mit ihrer Rechnungssoftware interagieren. Der Server läuft lokal auf deinem Rechner mit Node.js 20 oder neuer und benötigt ein kostenpflichtiges BillingEngine-Konto sowie einen gültigen API-Key, um zu funktionieren.
Nutzer können verschiedene administrative Aufgaben erledigen, darunter die Suche nach Kunden mit find_customers, das Erstellen von Rechnungsentwürfen und das Auflisten bestehender Rechnungen mit spezifischen Filtern. Das Toolset ermöglicht zudem das Erfassen von Zahlungen sowie das Herunterladen von PDF- oder XML-E-Rechnungen direkt in deinen Downloads-Ordner. Da der Server nur Rechnungsentwürfe erstellt, werden keine Dokumente automatisch an Kunden gesendet. So stellst du sicher, dass du jeden Eintrag vor dem Abschluss prüfen kannst. Das System unterliegt einem Limit von 60 Requests pro Minute pro API-Key.
Was du damit machen kannst
- 1Neue Rechnungsentwürfe generierenBitte die AI, einen neuen Rechnungsentwurf für einen bestimmten Kunden und einen bestimmten Betrag zu erstellen.
- 2Offene Zahlungen trackenIdentifiziere über eine Abfrage im System, welche Kunden überfällige Rechnungen haben.
- 3Eingegangene Zahlungen protokollierenSage der AI, eine Zahlung für eine spezifische Rechnungsnummer zu erfassen.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du BillingEngine MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenBillingEngine MCP in Claude Code installieren
$ claude mcp add --env 'BILLINGENGINE_API_KEY=<YOUR_BILLINGENGINE_API_KEY>' billingengine-mcp -- npx -y billingengine-mcpBillingEngine MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"billingengine-mcp": {
"command": "npx",
"args": [
"-y",
"billingengine-mcp"
],
"env": {
"BILLINGENGINE_API_KEY": "<YOUR_BILLINGENGINE_API_KEY>"
}
}
}
}BillingEngine MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"billingengine-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"billingengine-mcp"
],
"env": {
"BILLINGENGINE_API_KEY": "<YOUR_BILLINGENGINE_API_KEY>"
}
}
}
}BillingEngine MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"billingengine-mcp","type":"stdio","command":"npx","args":["-y","billingengine-mcp"],"env":{"BILLINGENGINE_API_KEY":"<YOUR_BILLINGENGINE_API_KEY>"}}'BillingEngine MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"billingengine-mcp": {
"command": "npx",
"args": [
"-y",
"billingengine-mcp"
],
"env": {
"BILLINGENGINE_API_KEY": "<YOUR_BILLINGENGINE_API_KEY>"
}
}
}
}BillingEngine MCP in Codex installieren
$ codex mcp add billingengine-mcp --env 'BILLINGENGINE_API_KEY=<YOUR_BILLINGENGINE_API_KEY>' -- npx -y billingengine-mcpBillingEngine MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.billingengine-mcp] command = "npx" args = ["-y", "billingengine-mcp"] [mcp_servers.billingengine-mcp.env] BILLINGENGINE_API_KEY = "<YOUR_BILLINGENGINE_API_KEY>"
BillingEngine MCP in Gemini CLI installieren
$ gemini mcp add -s user -e 'BILLINGENGINE_API_KEY=<YOUR_BILLINGENGINE_API_KEY>' billingengine-mcp npx -- -y billingengine-mcpBillingEngine MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"billingengine-mcp": {
"command": "npx",
"args": [
"-y",
"billingengine-mcp"
],
"env": {
"BILLINGENGINE_API_KEY": "<YOUR_BILLINGENGINE_API_KEY>"
}
}
}
}BillingEngine MCP tools 10
Erkannt aus dem READMEfind_customerscreate_customerupdate_customercreate_invoiceupdate_invoicelist_invoicesget_invoicedownload_invoicerecord_paymentlist_payments
| find_customers | — | |
| create_customer | — | |
| update_customer | — | |
| create_invoice | — | |
| update_invoice | — | |
| list_invoices | — | |
| get_invoice | — | |
| download_invoice | — | |
| record_payment | — | |
| list_payments | — |
Konfiguration
BILLINGENGINE_API_KEYErforderlichSecretAPI key from Settings > API keys in BillingEngine (paid plans only)
| Name | Beschreibung | Typ |
|---|---|---|
| BILLINGENGINE_API_KEY | API key from Settings > API keys in BillingEngine (paid plans only) | ErforderlichSecret |
Automatisierte Checks
Geluften am 12. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbarBestanden
- Open Source Lizenz (OSI)Bestanden
- Commit oder Release im letzten JahrBestanden
- Package-Name ähnelt keinem populären PackageBestanden
- Remote Endpoint nutzt HTTPSNicht geprüft
- Destruktive Tools sind markiertBestanden
- Keine versteckten Anweisungen an das ModellBestanden
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenBestanden
README
Auf GitHub ansehenBillingEngine MCP server
Create customers and invoices, look up open invoices and record payments in BillingEngine by talking to Claude, Cursor or any other MCP client:
"Create an invoice for Acme Painting over 100 euros."
"Which invoices are overdue?"
"Acme paid invoice 2610030028, record the payment."
BillingEngine is invoicing software for freelancers and small businesses with e-invoicing (EN 16931, XRechnung, ZUGFeRD / Factur-X). The server is a thin layer over the BillingEngine API and runs on your computer.
Requirements
- Node.js 20 or newer
- A BillingEngine account on a paid plan. The API is not available in the Free plan.
- Your API key from Settings > API keys in BillingEngine
Setup
Claude Desktop
Add this to claude_desktop_config.json:
{
"mcpServers": {
"billingengine": {
"command": "npx",
"args": ["-y", "billingengine-mcp"],
"env": { "BILLINGENGINE_API_KEY": "your-api-key" }
}
}
}
Claude Code
claude mcp add billingengine --env BILLINGENGINE_API_KEY=your-api-key -- npx -y billingengine-mcp
Cursor and other clients
Use the same command, args and env as above in the MCP settings of your client.
Tools
| Tool | What it does |
|---|---|
find_customers |
Searches customers by company, name, email or identifier of another system |
create_customer |
Creates a customer |
update_customer |
Changes a customer |
create_invoice |
Creates a draft invoice for a customer |
update_invoice |
Changes a draft invoice |
list_invoices |
Lists invoices, filtered by status, type, customer, number, identifier or date |
get_invoice |
Returns one invoice with items, tax breakdown and status |
download_invoice |
Saves the PDF or the XML e-invoice to your Downloads folder |
record_payment |
Records a payment for sent invoices |
list_payments |
Lists payments, optionally for one invoice |
What it does and does not do
- Invoices are created as drafts. Nothing is sent to your customers; you review and send the invoice in BillingEngine. Every result contains a link to open the draft.
- Prices are net or gross, as set in your account; every invoice says which. Amounts in results are decimal strings such as
"119.00". Number, language, texts, VAT treatment and payment terms come from your account settings, exactly as in the invoice form. - Nothing can be deleted through this server.
- New invoices count towards the monthly invoice maximum of your plan.
- The API allows 60 requests per minute per key.
- Your key stays on your computer and is only sent to BillingEngine.
If a key is ever exposed, create a new one under Settings > API keys. The old key stops working immediately. The settings also show when the key was last used.
Configuration
| Variable | Meaning |
|---|---|
BILLINGENGINE_API_KEY |
Your API key (required) |
BILLINGENGINE_URL |
Base URL, defaults to https://www.billingengine.com |
Development
npm install
npm run build
BILLINGENGINE_API_KEY=... node dist/index.js
License
MIT. BillingEngine itself is a commercial service; see billingengine.com.
BillingEngine MCP Fragen
Wie füge ich BillingEngine MCP zu Claude Code hinzu?
Führe claude mcp add --env 'BILLINGENGINE_API_KEY=<YOUR_BILLINGENGINE_API_KEY>' billingengine-mcp -- npx -y billingengine-mcp in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich BillingEngine MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Welche Tools bietet BillingEngine MCP?
Er stellt 10 Tools bereit, darunter find_customers, create_customer, update_customer, create_invoice, update_invoice.
Kann ich Rechnungen über diesen Server direkt an Kunden senden?
Nein, Rechnungen werden als Entwürfe erstellt, damit du sie in BillingEngine prüfen und manuell versenden kannst.
Ist es möglich, Datensätze über den MCP server zu löschen?
Nein, der Server unterstützt keine Löschvorgänge.
Wie hoch sind die API Rate Limits?
Die API erlaubt 60 Requests pro Minute pro API-Key.
Wird dieser Server im Free-Plan unterstützt?
Nein, du benötigst einen kostenpflichtigen Plan, da die API im Free-Plan nicht verfügbar ist.