BillingEngine MCP server
OfficialBillingEngine MCP is a thin wrapper over the BillingEngine invoicing API for managing customers, invoices and payments.
Customers: search customers by company/name/email/identifier (
find_customers), create (create_customer) and update them (update_customer)Invoices: create and edit draft invoices with line items, tax rates, dates and payment terms (
create_invoice,update_invoice); list them filtered by status (draft/open/overdue/paid), customer, number or date (list_invoices); fetch a single invoice with items, tax breakdown and status (get_invoice)Downloads: save an invoice's PDF or XML e-invoice to a local folder (
download_invoice)Payments: record a gross payment against one or more open invoices of the same customer and tax rate (
record_payment); list recorded payments (list_payments)Limitations: invoices are always created as drafts (nothing is sent automatically), nothing can be deleted, the API is rate-limited to 60 requests/minute and requires a paid plan API key.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@BillingEngine MCP server Create a draft invoice for Malermeister Müller for 100 euros."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
BillingEngine 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
Related MCP server: InvoiceBloom MCP server
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-mcpCursor and other clients
Use the same command, args and env as above in the MCP settings of your client.
Tools
Tool | What it does |
| Searches customers by company, name, email or identifier of another system |
| Creates a customer |
| Changes a customer |
| Creates a draft invoice for a customer |
| Changes a draft invoice |
| Lists invoices, filtered by status, type, customer, number, identifier or date |
| Returns one invoice with items, tax breakdown and status |
| Saves the PDF or the XML e-invoice to your Downloads folder |
| Records a payment for sent invoices |
| 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 |
| Your API key (required) |
| Base URL, defaults to |
Development
npm install
npm run build
BILLINGENGINE_API_KEY=... node dist/index.jsLicense
MIT. BillingEngine itself is a commercial service; see billingengine.com.
Available Tools
10 toolscreate_customerCreate a customerA
Creates a customer. Needs a company or a last name and a full address (line 1, postal code, city, country).
Inputs: address (required), email, phone, company, +4 more. Returns: object
create_invoiceCreate a draft invoiceA
Creates a draft invoice for a customer. Number, language, texts and VAT treatment come from the account settings. The invoice is not sent; it counts towards the monthly invoice maximum of the plan.
Inputs: items (required), customer_id (required), date, due_days, +4 more. Returns: object
download_invoiceDownload an invoice fileAIdempotent
Saves the PDF or the XML e-invoice of an invoice on this computer and returns the file path. Defaults to the Downloads folder.
Inputs: id (required), format, directory. Returns: object
find_customersFind customersARead-only
Lists customers, optionally filtered by a search text that matches company, names and email.
Inputs: page, query. Returns: object
get_invoiceGet an invoiceBRead-only
Returns one invoice with its items, amounts and payment status.
Inputs: id (required). Returns: object
list_invoicesList invoicesBRead-only
Lists invoices, newest first. Status: draft, open (sent and unpaid), overdue (open and past due) or paid.
Inputs: page, after, before, number, +3 more. Returns: object
list_paymentsList paymentsARead-only
Lists recorded payments, newest first, optionally only those for one invoice.
Inputs: page, invoice_id. Returns: object
record_paymentRecord a paymentA
Records a payment for one or more sent, open invoices of the same customer and tax rate. The amount is gross.
Inputs: amount (required), invoice_ids (required), date, payment_method. Returns: object
update_customerUpdate a customerAIdempotent
Changes the given fields of a customer; fields that are left out stay as they are.
Inputs: id (required), email, phone, address, +5 more. Returns: object
update_invoiceUpdate a draft invoiceAIdempotent
Changes a draft invoice. Passing items replaces all existing items, so send the complete list. Sent invoices cannot be changed.
Inputs: id (required), date, items, due_days, +4 more. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Each tool targets a clearly distinct resource and action: customers (find/create/update), invoices (create/update/list/get/download), and payments (record/list). There is no meaningful overlap between tools, and an agent can easily select the right one based on the requested resource and operation.
All tools use snake_case with a verb_noun pattern, which is highly consistent. The only minor deviation is using 'find_customers' for listing customers while invoices and payments use 'list_*', but this does not create confusion.
With 10 tools, the set is well-scoped for a billing engine, covering the core customer, invoice, and payment operations without excessive bloat. Each tool has a clear place in the domain.
The surface covers create/read/update for customers and invoices plus payment recording, but it lacks a tool to send a draft invoice, which is a critical step because record_payment only works on sent/open invoices. Deletion operations for any entity are also absent, creating notable workflow gaps.
Maintenance
Related MCP Connectors
Create, send and track invoices from a conversation in Claude, ChatGPT or any MCP client that supports OAuth. Draft an invoice from one sentence or from last month's invoice for the same client, finalize it, email it to your client and send payment reminders for overdue ones. See revenue by month and by client, download PDFs and e-invoices (ZUGFeRD, XRechnung), and export DATEV packages for your tax advisor. Invoices follow the tax rules of 25 countries, including reverse charge and the small-business VAT exemption. New invoices are drafts, and nothing is emailed until you ask. Pay per invoice with no subscription: the first invoice is free.
Free hosted MCP for invoices, estimates, clients, items and PDFs. OAuth authorization required.
API-first CRM for LLMs - contacts, companies, deals and activities over a native MCP server.
Invoicing you drive by talking to your AI: log time, raise invoices and track what's owed via MCP.
Related MCP Servers
AlicenseAqualityDmaintenanceUnofficial MCP server to operate MakeLeaps clients, quotes, and invoices from LLMs via the MakeLeaps API, with local execution and no telemetry.8MIT- AlicenseNot gradedqualityCmaintenanceEnables creating, sending, and tracking invoices from MCP clients like Claude, Cursor, or Windsurf, using a hosted endpoint with API token.MIT
- AlicenseNot gradedqualityBmaintenanceExposes French electronic invoicing as a local stdio MCP server, letting an AI client create EN 16931-compliant Factur-X invoices with guaranteed legal numbering, client and organization management, and invoice history. It can also submit a generated invoice to a French e-invoicing platform (PDP) after explicit confirmation.5AGPL 3.0
- AlicenseBqualityBmaintenanceEnables Claude and other MCP clients to manage a small-business back office, including clients, quotes, invoices, payments, reports, and PDF invoice export, while keeping data in a local SQLite file.21MIT