BillingEngine

com.billingenginev0.1.1更新于 Oct 3, 2026

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

已验证STDIO仅桌面Business & CommerceFinance

概览

AI 生成的概览

让助手在 BillingEngine 中创建客户和草稿发票、查询发票并记录付款。

功能
这是一个本地 MCP 服务器，封装了面向自由职业者和小型企业的 BillingEngine 开票 API。工具涵盖查找、创建和修改客户；创建和修改草稿发票；按状态、客户、编号或日期列出并获取含明细和付款状态的发票；将 PDF 或 XML 电子发票下载到本地；以及记录和列出付款。发票始终以草稿形式创建，且无法通过该服务器删除任何内容。
适用场景
如果你已在 BillingEngine 付费方案上处理开票，并希望通过 Claude Desktop、Claude Code 或 Cursor 等 MCP 客户端起草发票、查看哪些发票逾期或登记付款，而不想使用网页界面，那么这个服务器适合你。
运行要求
需要 Node.js 20 或更高版本，以通过 stdio 在本地运行 npm 包 billingengine-mcp。需要 BillingEngine 付费方案账户（免费方案不提供 API），以及来自“设置 > API”的 API 密钥，通过环境变量 BILLINGENGINE_API_KEY 提供。需要访问 BillingEngine 的网络连接；基础 URL 可用 BILLINGENGINE_URL 覆盖。
安装前请注意
需要机密信息 BILLINGENGINE_API_KEY，该密钥会发送给 BillingEngine；一旦泄露，请在“设置 > API”中重新生成。该服务器会写入数据：创建和修改客户与发票、记录付款，不过发票保持草稿状态且无法删除任何内容。新发票会占用方案的每月发票上限，且 API 限制每个密钥每分钟 60 次请求。

安装

在 SourceWeft 中

  1. 打开 控制台中的 BillingEngine，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

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.

来源：README.md，提交 148e09d

工具

0
工具元数据尚未被收录。

版本历史

1
  1. v0.1.1最新Oct 3, 2026