English Français العربية

BillingEngine

السجل الرسمي المالية والمدفوعات

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

الشيفرة المصدرية الموقع التوثيق

ماذا يمكنك أن تفعل مع BillingEngine؟

  • Invoices are created as drafts. Nothing is sent to your customers; you review and send
  • 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
  • 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.

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package billingengine-mcp
Claude Code 
claude mcp add billingengine -e 'BILLINGENGINE_API_KEY=<your billingengine_api_key>' -- npx -y billingengine-mcp@0.2.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "billingengine": {
            "command": "npx",
            "args": [
                "-y",
                "billingengine-mcp@0.2.0"
            ],
            "env": {
                "BILLINGENGINE_API_KEY": "<your billingengine_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • BILLINGENGINE_API_KEY إلزامي سري API key from Settings > API keys in BillingEngine (paid plans only)

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. BillingEngine MCP server
  2. Requirements
  3. Setup
  4. Tools
  5. What it does and does not do
  6. Configuration
  7. Development
  8. License

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

ToolWhat it does
find_customersSearches customers by company, name, email or identifier of another system
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, type, customer, number, identifier or date
get_invoiceReturns one invoice with items, tax breakdown and 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 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

VariableMeaning
BILLINGENGINE_API_KEYYour API key (required)
BILLINGENGINE_URLBase 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؟

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

كيف أثبّت BillingEngine؟

يعمل على جهازك. في Claude Code: claude mcp add billingengine -e 'BILLINGENGINE_API_KEY=<your billingengine_api_key>' -- npx -y billingengine-mcp@0.2.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج BillingEngine إلى مفتاح API؟

نعم. يتطلب BILLINGENGINE_API_KEY، وتضبطها في إعداداته.

هل BillingEngine مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون BillingEngine؟

ينشره billingengine. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.