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