How do I install BillingEngine?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does BillingEngine need an API key?

The publisher lists these environment variables: BILLINGENGINE_API_KEY.

What transport does BillingEngine use?

BillingEngine runs locally over stdio.

When was BillingEngine last checked?

Last checked 2026-11-11. Create invoices and customers and record payments in BillingEngine from any MCP client.

BillingEngine MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y [email protected]

Credentials from the publisher

BILLINGENGINE_API_KEY — API key from Settings > API keys in BillingEngine (paid plans only)

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1BILLINGENGINE_API_KEY=<secret> claude mcp add com.billingengine-mcp -- npx -y billingengine-mcp@0.2.2

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "com.billingengine-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ],9      "env": {10        "BILLINGENGINE_API_KEY": "<secret>"11      }12    }13  }14}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.2.2
API key

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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

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.

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install BillingEngine?

Does BillingEngine need an API key?

What transport does BillingEngine use?

When was BillingEngine last checked?

Documentation

BillingEngine MCP server

Requirements

Setup

Claude Desktop

Claude Code

Cursor and other clients

Tools

What it does and does not do

Configuration

Development

License