BillingEngine

com.billingenginev0.1.1Updated Oct 3, 2026

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

VerifiedSTDIODesktop onlyBusiness & CommerceFinance

Overview

AI-generated overview

Lets an assistant create customers and draft invoices, look up invoices, and record payments in BillingEngine.

What it does
A local MCP server that wraps the BillingEngine invoicing API for freelancers and small businesses. Tools cover finding, creating and updating customers; creating and updating draft invoices; listing and retrieving invoices with items and payment status; downloading the PDF or XML e-invoice; and recording and listing payments. Invoices are always created as drafts, and nothing can be deleted through the server.
When to use it
Useful if you already run your invoicing on a paid BillingEngine plan and want to draft invoices, check which are overdue, or log payments from an MCP client such as Claude Desktop, Claude Code or Cursor instead of the web interface.
Requirements
Node.js 20 or newer to run the npm package billingengine-mcp locally over stdio. A BillingEngine account on a paid plan (the API is not available on the Free plan) and an API key from Settings > API, supplied as the environment variable BILLINGENGINE_API_KEY. Network access to BillingEngine; the base URL can be overridden with BILLINGENGINE_URL.
Before you install
Requires the secret BILLINGENGINE_API_KEY, which is sent to BillingEngine; if it is exposed, regenerate it in Settings > API. The server writes data: it creates and updates customers and invoices and records payments, though invoices stay drafts and nothing can be deleted. New invoices count towards your plan's monthly invoice maximum, and the API allows 60 requests per minute per key.

Installation

In SourceWeft

  1. Open BillingEngine in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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 in BillingEngine

Setup

Claude Desktop

Add this to claude_desktop_config.json:

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

Claude Code

sh
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

ToolWhat it does
find_customersSearches customers by company, name or email
create_customerCreates a customer
update_customerChanges a customer
create_invoiceCreates a draft invoice for a customer
update_invoiceChanges a draft invoice
list_invoicesLists invoices, filtered by status, customer, number or date
get_invoiceReturns one invoice with items and payment status
download_invoiceSaves the PDF or the XML e-invoice to your Downloads folder
record_paymentRecords a payment for sent invoices
list_paymentsLists 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. 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, generate a new one under Settings > API. The old key stops working immediately. The settings also show when the key was last used.

Configuration

VariableMeaning
BILLINGENGINE_API_KEYYour API key (required)
BILLINGENGINE_URLBase URL, defaults to https://www.billingengine.com

Development

sh
npm installnpm run buildBILLINGENGINE_API_KEY=... node dist/index.js

License

MIT. BillingEngine itself is a commercial service; see billingengine.com.

Source: README.md at commit 148e09d

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v0.1.1LatestOct 3, 2026