BillingEngine APIを介して、AIクライアントによる顧客管理、請求書の下書き作成、請求書一覧の取得、および支払記録の登録を可能にします。
別名 billingengine/billingengine-mcp, billingengine-mcp
- スター
- 0
- ツール
- 10
- ダウンロード数(30日間)
- 841
- 最新バージョン
- 0.2.2
- 最終コミット
- 2026年11月6日
- ライセンス
- MIT
BillingEngine MCPとは
BillingEngine APIを介して、AIクライアントによる顧客管理、請求書の下書き作成、請求書一覧の取得、および支払記録の登録を可能にします。 10個のツールを提供しており、find_customers, create_customer, update_customerなどがあります。
プロジェクトのREADMEから生成された概要
BillingEngine MCP server について
このサーバーは、フリーランスや小規模ビジネスのオーナーが、AIインターフェースを通じて顧客レコードや財務書類を管理できるようにします。BillingEngine APIに接続することで、Claude Desktop、Cursor、Claude Codeなどのクライアントから、自然言語を使用して請求ソフトを操作できます。サーバーはNode.js 20以降を使用してローカル環境で動作し、利用には有料のBillingEngineアカウントと有効なAPIキーが必要です。
ユーザーは、find_customersによる顧客検索、請求書の下書き作成、特定のフィルターを使用した既存の請求書一覧の取得など、さまざまな管理タスクを実行できます。また、支払いの記録や、PDFまたはXML形式の電子請求書をダウンロードフォルダに直接保存することも可能です。このサーバーは請求書を下書きとして作成するのみであるため、ドキュメントが自動的に顧客へ送信されることはありません。これにより、最終確定前にすべての内容をレビューできます。なお、システムにはAPIキーごとに1分間60リクエストの制限があります。
できること
- 1新しい請求書の下書きを作成特定のクライアントと金額を指定して、AIに新しい請求書の下書きを作成させます。
- 2未払いの支払いを追跡システムに問い合わせて、どの顧客の請求書が期限切れになっているかを特定します。
- 3入金記録を登録特定の請求書番号に対して、AIに支払いの記録を指示します。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
BillingEngine MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにBillingEngine MCPをインストール
$ claude mcp add --env 'BILLINGENGINE_API_KEY=<YOUR_BILLINGENGINE_API_KEY>' billingengine-mcp -- npx -y billingengine-mcpCursorにBillingEngine MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"billingengine-mcp": {
"command": "npx",
"args": [
"-y",
"billingengine-mcp"
],
"env": {
"BILLINGENGINE_API_KEY": "<YOUR_BILLINGENGINE_API_KEY>"
}
}
}
}VS CodeにBillingEngine MCPをインストール
.vscode/mcp.json
{
"servers": {
"billingengine-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"billingengine-mcp"
],
"env": {
"BILLINGENGINE_API_KEY": "<YOUR_BILLINGENGINE_API_KEY>"
}
}
}
}VS Code CLIにBillingEngine MCPをインストール
$ code --add-mcp '{"name":"billingengine-mcp","type":"stdio","command":"npx","args":["-y","billingengine-mcp"],"env":{"BILLINGENGINE_API_KEY":"<YOUR_BILLINGENGINE_API_KEY>"}}'Claude DesktopにBillingEngine MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"billingengine-mcp": {
"command": "npx",
"args": [
"-y",
"billingengine-mcp"
],
"env": {
"BILLINGENGINE_API_KEY": "<YOUR_BILLINGENGINE_API_KEY>"
}
}
}
}CodexにBillingEngine MCPをインストール
$ codex mcp add billingengine-mcp --env 'BILLINGENGINE_API_KEY=<YOUR_BILLINGENGINE_API_KEY>' -- npx -y billingengine-mcpCodex config.tomlにBillingEngine MCPをインストール
~/.codex/config.toml
[mcp_servers.billingengine-mcp] command = "npx" args = ["-y", "billingengine-mcp"] [mcp_servers.billingengine-mcp.env] BILLINGENGINE_API_KEY = "<YOUR_BILLINGENGINE_API_KEY>"
Gemini CLIにBillingEngine MCPをインストール
$ gemini mcp add -s user -e 'BILLINGENGINE_API_KEY=<YOUR_BILLINGENGINE_API_KEY>' billingengine-mcp npx -- -y billingengine-mcpGemini settings.jsonにBillingEngine MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"billingengine-mcp": {
"command": "npx",
"args": [
"-y",
"billingengine-mcp"
],
"env": {
"BILLINGENGINE_API_KEY": "<YOUR_BILLINGENGINE_API_KEY>"
}
}
}
}BillingEngine MCPツール 10
READMEから検出find_customerscreate_customerupdate_customercreate_invoiceupdate_invoicelist_invoicesget_invoicedownload_invoicerecord_paymentlist_payments
| find_customers | — | |
| create_customer | — | |
| update_customer | — | |
| create_invoice | — | |
| update_invoice | — | |
| list_invoices | — | |
| get_invoice | — | |
| download_invoice | — | |
| record_payment | — | |
| list_payments | — |
設定
BILLINGENGINE_API_KEY必須シークレットAPI key from Settings > API keys in BillingEngine (paid plans only)
| 名前 | 説明 | 種類 |
|---|---|---|
| BILLINGENGINE_API_KEY | API key from Settings > API keys in BillingEngine (paid plans only) | 必須シークレット |
自動チェック
実行日 2026年11月12日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能合格
- オープンソースライセンス (OSI)合格
- 過去1年以内にコミットまたはリリースあり合格
- パッケージ名が有名なパッケージに酷似していない合格
- リモートエンドポイントがHTTPSを使用未チェック
- 破壊的なツールがラベル付けされている合格
- モデルへの隠れた指示がない合格
- パッケージおよびその依存関係に重大な勧告なし合格
README
GitHubで見る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.
BillingEngine MCPのよくある質問
BillingEngine MCPをClaude Codeに追加するには
ターミナルでclaude mcp add --env 'BILLINGENGINE_API_KEY=<YOUR_BILLINGENGINE_API_KEY>' billingengine-mcp -- npx -y billingengine-mcpを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
BillingEngine MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
BillingEngine MCPが提供するツールは
10個のツールを提供しており、find_customers, create_customer, update_customer, create_invoice, update_invoiceなどがあります。
このサーバーを使用して、顧客に直接請求書を送信できますか?
いいえ、請求書は下書きとして作成されます。BillingEngine内で内容を確認し、手動で送信してください。
MCP server経由でレコードを削除することはできますか?
いいえ、このサーバーは削除操作をサポートしていません。
APIのレート制限はありますか?
APIキーごとに1分間に60リクエストまで可能です。
無料プランでもこのサーバーを利用できますか?
いいえ、無料プランではAPIが利用できないため、有料プランが必要です。