BillingEngine — Claude Code MCP server: what it does, how to install
Connects your assistant to BillingEngine to prepare draft invoices, find client records, and register incoming payments.
claude mcp add mcp -e BILLINGENGINE_API_KEY=<BILLINGENGINE_API_KEY> -- npx -y billingengine-mcpWhat BillingEngine does
This server runs locally as a bridge to the BillingEngine API. It equips your assistant with tools such as create_invoice, find_customers, and record_payment right in the chat. You can also trigger download_invoice to save generated PDF or XML documents to your Downloads directory.
Safety limits are built in by default. New invoices are generated solely as drafts, meaning nothing gets mailed to your buyers without your manual approval in the web interface. Nothing can be deleted through the tools.
The server requires Node.js 20 or newer and an active paid plan, because the free tier lacks API access. You must provide your credential using BILLINGENGINE_API_KEY.
What it helps with
- draft customer invoices from chat prompts
- look up client profiles by email or organization name
- review unpaid or overdue invoices
- log incoming payments against existing bills
- save invoice PDF and XML files to the local machine
Example prompts for the agent
- Create a draft invoice for Acme Painting for 100 euros
- Which invoices are overdue right now?
- Acme paid invoice 2610030028, record the payment
How to install BillingEngine
Platform CLI
claude mcp add mcp -e BILLINGENGINE_API_KEY=<BILLINGENGINE_API_KEY> -- npx -y billingengine-mcpReplace <…> with your own values
Platform CLI
codex mcp add billingengine --env BILLINGENGINE_API_KEY=<BILLINGENGINE_API_KEY> -- npx -y billingengine-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"billingengine": {
"command": "npx",
"args": [
"-y",
"billingengine-mcp"
],
"env": {
"BILLINGENGINE_API_KEY": "<BILLINGENGINE_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"billingengine": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"billingengine-mcp"
],
"env": {
"BILLINGENGINE_API_KEY": "<BILLINGENGINE_API_KEY>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e BILLINGENGINE_API_KEY=<BILLINGENGINE_API_KEY> billingengine npx -y billingengine-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about BillingEngine
How do I install BillingEngine in Claude Code?
Run claude mcp add --env BILLINGENGINE_API_KEY=<BILLINGENGINE_API_KEY> --transport stdio billingengine -- npx -y billingengine-mcp replacing the placeholder with your key from the BillingEngine settings.
What does the BillingEngine MCP server do?
It gives your assistant access to BillingEngine endpoints, enabling you to inspect accounts, draft bills, and log payment receipts directly inside the editor.
Does the server deliver invoices to clients automatically?
No, every invoice is created strictly as a draft. You review and send out the final document manually in BillingEngine.
