Create invoices and customers and record payments in BillingEngine from any MCP client.
com.billingengine/mcp (MCP)
The com.billingengine/mcp MCP server allows any MCP client to create invoices and customers and to record payments in BillingEngine. Its description indicates it is designed to perform these BillingEngine operations over MCP for external applications.
🛠️ Key Features
Create invoices in BillingEngine
Create customers in BillingEngine
Record payments in BillingEngine
🚀 Use Cases
Integrate an MCP client with BillingEngine for invoice generation
Manage customer records via an MCP client
Log payment events in BillingEngine from an MCP client
⚡ Developer Benefits
Centralizes BillingEngine actions (invoices, customers, payments) through an MCP server
Enables MCP client-driven workflows for BillingEngine data updates
⚠️ Limitations
Supported capabilities are limited to the operations stated: invoices, customers, and payments
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.
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 or email
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, customer, number or date
get_invoice
Returns one invoice with items and payment 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. 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, generate a new one under Settings > API. 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
sh
npm install
npm run build
BILLINGENGINE_API_KEY=... node dist/index.js
License
MIT. BillingEngine itself is a commercial service; see billingengine.com.
Install
Configuration
Environment variables
BILLINGENGINE_API_KEYrequiredsecret
API key from Settings > API in BillingEngine (paid plans only)