Allows AI clients to manage customers, create draft invoices, list invoices, and record payments via the BillingEngine API.
Also known as billingengine/billingengine-mcp, billingengine-mcp
- Stars
- 0
- Tools
- 10
- Downloads, 30 days
- 841
- Latest version
- 0.2.2
- Last commit
- Nov 6, 2026
- License
- MIT
What is BillingEngine MCP?
BillingEngine allows AI clients to manage customers, create draft invoices, list invoices, and record payments via the BillingEngine API. It exposes 10 tools, such as find_customers, create_customer, update_customer.
Summary generated from the project's README
About BillingEngine MCP server
Managing customer records and financial documents through an AI interface is what this server enables for freelancers and small business owners. By connecting to the BillingEngine API, users can interact with their invoicing software using natural language via clients like Claude Desktop, Cursor, or Claude Code. The server runs locally on your computer using Node.js 20 or newer and requires a paid BillingEngine account and a valid API key to function.
Users can perform several administrative tasks including searching for customers with find_customers, creating draft invoices, and listing existing invoices with specific filters. The toolset also allows for recording payments and downloading PDF or XML e-invoices directly to your Downloads folder. Because the server only creates draft invoices, no documents are sent to customers automatically, ensuring you can review every entry before finalization. The system is subject to a limit of 60 requests per minute per API key.
What you can do with it
- 1Generate new billing draftsAsk the AI to create a new draft invoice for a specific client and amount.
- 2Track outstanding paymentsIdentify which customers have overdue invoices by querying the system.
- 3Log received fundsTell the AI to record a payment against a specific invoice number.
Written from the project's README. Every use case is checked against a quote from it.
How to install BillingEngine MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall BillingEngine MCP in Claude Code
$ claude mcp add --env 'BILLINGENGINE_API_KEY=<YOUR_BILLINGENGINE_API_KEY>' billingengine-mcp -- npx -y billingengine-mcpInstall BillingEngine MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"billingengine-mcp": {
"command": "npx",
"args": [
"-y",
"billingengine-mcp"
],
"env": {
"BILLINGENGINE_API_KEY": "<YOUR_BILLINGENGINE_API_KEY>"
}
}
}
}Install BillingEngine MCP in VS Code
.vscode/mcp.json
{
"servers": {
"billingengine-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"billingengine-mcp"
],
"env": {
"BILLINGENGINE_API_KEY": "<YOUR_BILLINGENGINE_API_KEY>"
}
}
}
}Install BillingEngine MCP in VS Code CLI
$ code --add-mcp '{"name":"billingengine-mcp","type":"stdio","command":"npx","args":["-y","billingengine-mcp"],"env":{"BILLINGENGINE_API_KEY":"<YOUR_BILLINGENGINE_API_KEY>"}}'Install BillingEngine MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"billingengine-mcp": {
"command": "npx",
"args": [
"-y",
"billingengine-mcp"
],
"env": {
"BILLINGENGINE_API_KEY": "<YOUR_BILLINGENGINE_API_KEY>"
}
}
}
}Install BillingEngine MCP in Codex
$ codex mcp add billingengine-mcp --env 'BILLINGENGINE_API_KEY=<YOUR_BILLINGENGINE_API_KEY>' -- npx -y billingengine-mcpInstall BillingEngine MCP in Codex config.toml
~/.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>"
Install BillingEngine MCP in Gemini CLI
$ gemini mcp add -s user -e 'BILLINGENGINE_API_KEY=<YOUR_BILLINGENGINE_API_KEY>' billingengine-mcp npx -- -y billingengine-mcpInstall BillingEngine MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"billingengine-mcp": {
"command": "npx",
"args": [
"-y",
"billingengine-mcp"
],
"env": {
"BILLINGENGINE_API_KEY": "<YOUR_BILLINGENGINE_API_KEY>"
}
}
}
}BillingEngine MCP tools 10
Detected from the 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 | — |
Configuration
BILLINGENGINE_API_KEYRequiredSecretAPI key from Settings > API keys in BillingEngine (paid plans only)
| Name | Description | |
|---|---|---|
| BILLINGENGINE_API_KEY | API key from Settings > API keys in BillingEngine (paid plans only) | RequiredSecret |
Automated checks
Ran Nov 12, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packagePass
- Remote endpoint uses HTTPSNot checked
- Destructive tools are labelledPass
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesPass
README
View on GitHubBillingEngine 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 questions
How do I add BillingEngine MCP to Claude Code?
Run claude mcp add --env 'BILLINGENGINE_API_KEY=<YOUR_BILLINGENGINE_API_KEY>' billingengine-mcp -- npx -y billingengine-mcp in your terminal. Add --scope user to make it available in every project.
How do I add BillingEngine MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does BillingEngine MCP provide?
It exposes 10 tools, including find_customers, create_customer, update_customer, create_invoice, update_invoice.
Can I send invoices directly to customers using this server?
No, invoices are created as drafts for you to review and send manually within BillingEngine.
Is it possible to delete records through the MCP server?
No, the server does not support any deletion operations.
What are the API rate limits?
The API allows for 60 requests per minute per API key.
Does the free plan support this server?
No, you must have a paid plan because the API is not available on the Free plan.