Memungkinkan client AI untuk mengelola pelanggan, membuat draf invoice, melihat daftar invoice, dan mencatat pembayaran melalui BillingEngine API.
Juga dikenal sebagai billingengine/billingengine-mcp, billingengine-mcp
- Stars
- 0
- Tools
- 10
- Unduhan, 30 hari
- 841
- Versi terbaru
- 0.2.2
- Commit terakhir
- 6 Nov 2026
- Lisensi
- MIT
Apa itu BillingEngine MCP?
Memungkinkan client AI untuk mengelola pelanggan, membuat draf invoice, melihat daftar invoice, dan mencatat pembayaran melalui BillingEngine API. Server ini menyediakan 10 tool, seperti find_customers, create_customer, update_customer.
Ringkasan dibuat dari README proyek
Tentang BillingEngine MCP server
Server ini memungkinkan freelancer dan pemilik bisnis kecil untuk mengelola data pelanggan serta dokumen keuangan melalui antarmuka AI. Dengan terhubung ke BillingEngine API, Anda dapat berinteraksi dengan software invoicing menggunakan bahasa alami melalui client seperti Claude Desktop, Cursor, atau Claude Code. Server ini berjalan secara lokal di komputer Anda menggunakan Node.js 20 atau versi terbaru dan memerlukan akun BillingEngine berbayar serta API key yang valid untuk berfungsi.
Pengguna dapat melakukan beberapa tugas administratif termasuk mencari pelanggan dengan find_customers, membuat draf invoice, dan melihat daftar invoice yang ada dengan filter tertentu. Toolset ini juga memungkinkan Anda untuk mencatat pembayaran dan mengunduh e-invoice format PDF atau XML langsung ke folder Downloads Anda. Karena server ini hanya membuat draf invoice, tidak ada dokumen yang dikirim ke pelanggan secara otomatis, sehingga Anda dapat meninjau setiap entri sebelum difinalisasi. Sistem ini memiliki batasan 60 request per menit per API key.
Apa yang bisa Anda lakukan dengannya
- 1Generate draf penagihan baruMinta AI untuk membuat draf invoice baru untuk klien dan nominal tertentu.
- 2Pantau pembayaran yang belum lunasIdentifikasi pelanggan mana yang memiliki invoice jatuh tempo dengan melakukan query ke sistem.
- 3Catat dana yang diterimaInstruksikan AI untuk mencatat pembayaran pada nomor invoice tertentu.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal BillingEngine MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal BillingEngine MCP di Claude Code
$ claude mcp add --env 'BILLINGENGINE_API_KEY=<YOUR_BILLINGENGINE_API_KEY>' billingengine-mcp -- npx -y billingengine-mcpInstal BillingEngine MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"billingengine-mcp": {
"command": "npx",
"args": [
"-y",
"billingengine-mcp"
],
"env": {
"BILLINGENGINE_API_KEY": "<YOUR_BILLINGENGINE_API_KEY>"
}
}
}
}Instal BillingEngine MCP di VS Code
.vscode/mcp.json
{
"servers": {
"billingengine-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"billingengine-mcp"
],
"env": {
"BILLINGENGINE_API_KEY": "<YOUR_BILLINGENGINE_API_KEY>"
}
}
}
}Instal BillingEngine MCP di VS Code CLI
$ code --add-mcp '{"name":"billingengine-mcp","type":"stdio","command":"npx","args":["-y","billingengine-mcp"],"env":{"BILLINGENGINE_API_KEY":"<YOUR_BILLINGENGINE_API_KEY>"}}'Instal BillingEngine MCP di Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"billingengine-mcp": {
"command": "npx",
"args": [
"-y",
"billingengine-mcp"
],
"env": {
"BILLINGENGINE_API_KEY": "<YOUR_BILLINGENGINE_API_KEY>"
}
}
}
}Instal BillingEngine MCP di Codex
$ codex mcp add billingengine-mcp --env 'BILLINGENGINE_API_KEY=<YOUR_BILLINGENGINE_API_KEY>' -- npx -y billingengine-mcpInstal BillingEngine MCP di Codex config.toml
~/.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>"
Instal BillingEngine MCP di Gemini CLI
$ gemini mcp add -s user -e 'BILLINGENGINE_API_KEY=<YOUR_BILLINGENGINE_API_KEY>' billingengine-mcp npx -- -y billingengine-mcpInstal BillingEngine MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"billingengine-mcp": {
"command": "npx",
"args": [
"-y",
"billingengine-mcp"
],
"env": {
"BILLINGENGINE_API_KEY": "<YOUR_BILLINGENGINE_API_KEY>"
}
}
}
}Tool BillingEngine MCP 10
Terdeteksi dari READMEfind_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 | — |
Konfigurasi
BILLINGENGINE_API_KEYWajibRahasiaAPI key from Settings > API keys in BillingEngine (paid plans only)
| Nama | Deskripsi | Tipe |
|---|---|---|
| BILLINGENGINE_API_KEY | API key from Settings > API keys in BillingEngine (paid plans only) | WajibRahasia |
Pengecekan otomatis
Berjalan 12 Nov 2026Laporan lengkap →Lolos checks otomatis kami. Ini bukan audit keamanan: baca kodenya dan berikan server akses paling terbatas yang dibutuhkannya. Cara kerja checks
- Source repository terhubung dan dapat dijangkauLolos
- Lisensi open source (OSI)Lolos
- Ada commit atau release dalam satu tahun terakhirLolos
- Nama package tidak mirip dengan package populerLolos
- Remote endpoint menggunakan HTTPSTidak diperiksa
- Tools yang bersifat destruktif telah diberi labelLolos
- Tidak ada instruksi tersembunyi untuk modelLolos
- Tidak ada advisory kritis pada paket atau dependensinyaLolos
README
Lihat di GitHubBillingEngine 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.
Pertanyaan tentang BillingEngine MCP
Bagaimana cara menambahkan BillingEngine MCP ke Claude Code?
Jalankan claude mcp add --env 'BILLINGENGINE_API_KEY=<YOUR_BILLINGENGINE_API_KEY>' billingengine-mcp -- npx -y billingengine-mcp di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan BillingEngine MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Tool apa yang disediakan BillingEngine MCP?
Server ini menyediakan 10 tool, termasuk find_customers, create_customer, update_customer, create_invoice, update_invoice.
Bisakah saya mengirim invoice langsung ke pelanggan menggunakan server ini?
Tidak, invoice dibuat sebagai draf agar Anda dapat meninjau dan mengirimnya secara manual di dalam BillingEngine.
Apakah mungkin untuk menghapus data melalui MCP server ini?
Tidak, server ini tidak mendukung operasi penghapusan apa pun.
Berapa limit rate API-nya?
API ini mengizinkan 60 request per menit per API key.
Apakah paket gratis mendukung server ini?
Tidak, Anda harus memiliki paket berbayar karena API tidak tersedia pada paket Free.