Is Billingengine free?

Yes, Billingengine is free to use.

How do I install Billingengine?

Billingengine is a local plugin. Install it using npm package: billingengine-mcp and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

Is Billingengine safe to use?

Yes. Billingengine passed MCP Marketplace's automated security scan with a score of 7.6/10 (low risk). Every server on MCP Marketplace is security-scanned before it's listed; see the full security report on this page for the findings and permissions.

What credentials does Billingengine need?

Billingengine requires the following credentials or environment variables: BILLINGENGINE_API_KEY. You can find setup instructions on the server detail page.

What AI apps work with Billingengine?

Billingengine uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Billingengine MCP Server

by Timo

Developer ToolsModerate7.6Local

Free

Create invoices and customers and record payments in BillingEngine from any MCP client.

About

Create invoices and customers and record payments in BillingEngine from any MCP client.

Security Report

7.6

Moderate7.6Low Risk

This is a legitimate BillingEngine invoicing MCP server that authenticates with a bearer key read from an environment variable and sends it only to the configured BillingEngine base URL. The main concern is that the download_invoice tool lets the model choose an arbitrary target directory for writing files, and the base URL override could redirect the API key if misconfigured. Permissions otherwise match the server's invoicing purpose. Supply chain analysis found 1 known vulnerability in dependencies (0 critical, 1 high severity). Package verification found 1 issue.

6 files analyzed · 6 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

File System Write

Writes or modifies files on your machine. Check that this is expected for the tool.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

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

Environment variable: BILLINGENGINE_API_KEY

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "com-billingengine-mcp": {
      "env": {
        "BILLINGENGINE_API_KEY": "your-billingengine-api-key-here"
      },
      "args": [
        "-y",
        "billingengine-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

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.

Reviews

No reviews yet

Security

4.8

Local

MCP Marketplace

Free

by mcp-marketplace · Developer Tools

Search and install MCP servers from inside your AI client.