Billingengine MCP logo

Billingengine MCP

Connects AI clients to BillingEngine for customer records, draft invoices, invoice files, and payment tracking.

Install Billingengine MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "billingengine-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "billingengine-mcp"
      ],
      "env": {
        "BILLINGENGINE_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 10 tools correctly ().

Overview

billingengine-mcp MCP server connects MCP clients to the BillingEngine API for customer, invoice, and payment workflows. It can search and manage customers, create or update draft invoices, inspect invoice status, download PDF or XML files, and record payments. Run it locally with Node.js and a BillingEngine API key from a paid account. Reach for it when an AI client needs to prepare invoices or review receivables without sending invoices automatically.

Use cases

  • Search customer records by company, name, or email
  • Create and revise draft invoices
  • Review overdue or filtered invoices
  • Download PDF or XML e-invoices
  • Record and inspect invoice payments

Key features

  • Customer search and management
  • Draft invoice creation and editing
  • Invoice filtering and status lookup
  • PDF and XML e-invoice downloads
  • Payment recording and listing
  • BillingEngine API configuration

Tools10

What Billingengine MCP lets your agent do. Expand a tool for its parameters.

Verified live~2.3k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked

Recent health check succeeded.

11/11 checks healthy over the last 45d

What it can do

From the 10 tools this server returned when we ran it; 10 declare their own safety hints.

Can delete or modify data · 2Makes network requests · 1Read-only tools · 8
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceNot published
Package age20 days
Maintainers1

Observed 2026-10-23 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 13d ago via OSV.dev · billingengine-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads545Package downloads in the last 30 days.
Last commit13d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed10Callable tools this server registers over MCP.
Directory activity7 viewsConfig copies, upvotes, and views on AllMCPs.

How Billingengine MCP works

What billingengine-mcp MCP server does

billingengine-mcp MCP server exposes BillingEngine customer, invoicing, e-invoicing, and payment operations through MCP. It is intended for freelancers and small businesses using BillingEngine. The server communicates with the BillingEngine API while running on the local computer.

Customer operations include searching by company, name, or email, creating new customers, and changing existing customer records. Invoice operations cover creating draft invoices, editing drafts, filtering invoice lists, and retrieving a specific invoice with its line items and payment status. Payment operations can record a payment against a sent invoice or list payments, including payments associated with a particular invoice.

How it works

The MCP client sends tool requests to the local process, which passes supported operations to BillingEngine. New invoices remain drafts. The server does not send them to customers; they must be reviewed and sent in BillingEngine. Results include a link for opening the draft.

Invoice amounts are net, while numbering, language, invoice text, VAT handling, and payment terms follow the settings in the BillingEngine account. The download operation saves either a PDF invoice or an XML e-invoice to the computer's Downloads folder. BillingEngine supports e-invoicing formats including EN 16931, XRechnung, and ZUGFeRD / Factur-X.

Setup and configuration

billingengine-mcp MCP server requires Node.js 20 or later, a BillingEngine account on a paid plan, and an API key created under BillingEngine's Settings > API page. The Free plan does not provide API access.

For Claude Desktop and other stdio-capable clients, configure the process with npx -y billingengine-mcp and pass the API key through the environment. Claude Code can be configured with its MCP add command. Cursor uses the same command, arguments, and environment settings in its MCP configuration.

  • BILLINGENGINE_API_KEY is required.
  • BILLINGENGINE_URL changes the API base URL and defaults to https://www.billingengine.com.

The API key remains on the local computer and is sent only to BillingEngine. If it is exposed, replace it in BillingEngine; the old key stops working immediately.

Tools and capabilities

The available tools are:

  • find_customers: search customers by company, name, or email.
  • create_customer and update_customer: create or change customer records.
  • create_invoice and update_invoice: create or edit draft invoices.
  • list_invoices: filter invoices by status, customer, number, or date.
  • get_invoice: retrieve invoice items and payment status.
  • download_invoice: save a PDF or XML e-invoice locally.
  • record_payment: record payments for sent invoices.
  • list_payments: list payments, optionally for one invoice.

Limitations and notes

The server cannot delete records. Creating invoices counts toward the monthly invoice limit of the BillingEngine plan, and the API permits 60 requests per minute per key. Because invoice creation produces drafts only, sending remains a separate action in BillingEngine. BillingEngine itself is a commercial service, separate from this MIT-licensed server.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Billingengine MCP

billingengine-mcp is an MCP server that connects Claude, Cursor, and other MCP clients to BillingEngine through its API. Its main tools search and manage customers, create and update draft invoices, inspect invoice and payment status, download invoice files, and record or list payments.

Install it by configuring your MCP client to run `npx -y billingengine-mcp` with `BILLINGENGINE_API_KEY` set. You need Node.js 20 or newer, a BillingEngine paid-plan account, and an API key from Settings > API.

Yes, billingengine-mcp works with Cursor through its MCP settings. Use the same command, arguments, and environment configuration as other clients, including `npx -y billingengine-mcp` and your BillingEngine API key.

No, billingengine-mcp creates invoices as drafts only. You must review and send each invoice in BillingEngine; the server returns a link that opens the draft.

No, billingengine-mcp does not provide deletion operations. Its supported actions include creating and updating customers, editing draft invoices, retrieving invoice data, downloading invoice files, and managing payment records.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewBillingengine MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/billingengine-mcp?style=directory)](https://allmcps.com/mcp/billingengine-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/billingengine-mcp"><img src="https://allmcps.com/api/badge/billingengine-mcp?style=directory" alt="Billingengine MCP on AllMCPs" /></a>