# BillingEngine

> BillingEngine is a paid MCP server for finance and payments. Create invoices and record payments in BillingEngine from Claude or Cursor. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** CLI, API
- **Website:** https://www.billingengine.com/en/mcp
- **Repository:** https://github.com/billingengine/billingengine-mcp
- **MCP Registry name:** com.billingengine/mcp
- **Categories:** finance and payments
- **Listing updated:** 2026-11-14

## About

This stdio server lets an assistant look up customers, draft invoices and log payments in your BillingEngine account. It is deliberately limited: invoices are created only as drafts, nothing is sent to customers, and nothing can be deleted. You review and send each invoice in BillingEngine yourself.

It runs on your computer with an API key from Settings, API keys, which is available on paid plans only. Each key allows 60 requests per minute, and new invoices count toward your plan's monthly invoice maximum. The settings show when a key was last used and let you revoke it.

Downloads save the PDF or the XML e-invoice locally. The source is MIT-licensed on GitHub.

## Features

- **Draft invoices:** Creates and edits invoices as drafts only.
- **Customer management:** Search, create and update customers.
- **Payment recording:** Record and list payments on sent invoices.
- **Invoice lookup:** Filter by status, customer, number or date.
- **PDF and XML export:** Saves the PDF or XML e-invoice locally.
- **Safe limits:** Cannot delete and never sends mail.

## Good for

- Ask which invoices are overdue
- Record a customer payment by invoice number
- Draft an invoice from a chat sentence
- Download an e-invoice XML

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp --env BILLINGENGINE_API_KEY='<BILLINGENGINE_API_KEY>' -- npx -y billingengine-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "billingengine-mcp"
      ],
      "env": {
        "BILLINGENGINE_API_KEY": "<BILLINGENGINE_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "billingengine-mcp"
      ],
      "env": {
        "BILLINGENGINE_API_KEY": "<BILLINGENGINE_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "billingengine-mcp"
      ],
      "env": {
        "BILLINGENGINE_API_KEY": "<BILLINGENGINE_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "billingengine-mcp"
      ],
      "env": {
        "BILLINGENGINE_API_KEY": "<BILLINGENGINE_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "billingengine-mcp"
      ],
      "env": {
        "BILLINGENGINE_API_KEY": "<BILLINGENGINE_API_KEY>"
      }
    }
  }
}
```

## Tools

- `find_customers`: Searches customers by company, name or email.
- `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, customer, number or date.
- `get_invoice`: Returns one invoice with items and payment status.
- `download_invoice`: Saves the PDF or XML e-invoice locally.
- `record_payment`: Records a payment for sent invoices.
- `list_payments`: Lists payments, optionally for one invoice.

## FAQ

### Does it send invoices?

No. It creates drafts; you send them in BillingEngine.

### Which plans work?

Paid plans, since the API key is paid-only.

### Is there a rate limit?

60 requests per minute per key.

### Can it delete data?

No.

### Is BillingEngine free?

No. BillingEngine is a paid product.

### How do I add BillingEngine to Claude Code?

Run this command in your terminal: claude mcp add mcp --env BILLINGENGINE_API_KEY='<BILLINGENGINE_API_KEY>' -- npx -y billingengine-mcp

### What are the best alternatives to BillingEngine?

The closest alternatives to BillingEngine are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/billingengine
