Permite que los clientes de IA gestionen clientes, creen borradores de facturas, listen facturas y registren pagos a través de la API de BillingEngine.
También conocido como billingengine/billingengine-mcp, billingengine-mcp
- Stars
- 0
- Herramientas
- 10
- Descargas, 30 días
- 841
- Última versión
- 0.2.2
- Último commit
- 6 nov 2026
- Licencia
- MIT
¿Qué es BillingEngine MCP?
Permite que los clientes de IA gestionen clientes, creen borradores de facturas, listen facturas y registren pagos a través de la API de BillingEngine. Expone 10 herramientas, como find_customers, create_customer, update_customer.
Resumen generado a partir del README del proyecto
Acerca del MCP server de BillingEngine
Este servidor permite a freelancers y dueños de pequeñas empresas gestionar registros de clientes y documentos financieros mediante una interfaz de IA. Al conectarse a la API de BillingEngine, los usuarios pueden interactuar con su software de facturación usando lenguaje natural a través de clientes como Claude Desktop, Cursor o Claude Code. El servidor se ejecuta localmente en tu computadora usando Node.js 20 o superior y requiere una cuenta de pago de BillingEngine y una API key válida para funcionar.
Los usuarios pueden realizar diversas tareas administrativas, como buscar clientes con find_customers, crear borradores de facturas y listar facturas existentes con filtros específicos. El conjunto de herramientas también permite registrar pagos y descargar facturas electrónicas en PDF o XML directamente en tu carpeta de Descargas. Debido a que el servidor solo crea borradores de facturas, ningún documento se envía automáticamente a los clientes, lo que garantiza que puedas revisar cada entrada antes de la finalización. El sistema está sujeto a un límite de 60 solicitudes por minuto por API key.
Qué puedes hacer con él
- 1Generar nuevos borradores de facturaciónPide a la IA que cree un nuevo borrador de factura para un cliente y un monto específicos.
- 2Rastrear pagos pendientesIdentifica qué clientes tienen facturas vencidas consultando el sistema.
- 3Registrar fondos recibidosDile a la IA que registre un pago para un número de factura específico.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar BillingEngine MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar BillingEngine MCP en Claude Code
$ claude mcp add --env 'BILLINGENGINE_API_KEY=<YOUR_BILLINGENGINE_API_KEY>' billingengine-mcp -- npx -y billingengine-mcpInstalar BillingEngine MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"billingengine-mcp": {
"command": "npx",
"args": [
"-y",
"billingengine-mcp"
],
"env": {
"BILLINGENGINE_API_KEY": "<YOUR_BILLINGENGINE_API_KEY>"
}
}
}
}Instalar BillingEngine MCP en VS Code
.vscode/mcp.json
{
"servers": {
"billingengine-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"billingengine-mcp"
],
"env": {
"BILLINGENGINE_API_KEY": "<YOUR_BILLINGENGINE_API_KEY>"
}
}
}
}Instalar BillingEngine MCP en 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>"}}'Instalar BillingEngine MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"billingengine-mcp": {
"command": "npx",
"args": [
"-y",
"billingengine-mcp"
],
"env": {
"BILLINGENGINE_API_KEY": "<YOUR_BILLINGENGINE_API_KEY>"
}
}
}
}Instalar BillingEngine MCP en Codex
$ codex mcp add billingengine-mcp --env 'BILLINGENGINE_API_KEY=<YOUR_BILLINGENGINE_API_KEY>' -- npx -y billingengine-mcpInstalar BillingEngine MCP en 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>"
Instalar BillingEngine MCP en Gemini CLI
$ gemini mcp add -s user -e 'BILLINGENGINE_API_KEY=<YOUR_BILLINGENGINE_API_KEY>' billingengine-mcp npx -- -y billingengine-mcpInstalar BillingEngine MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"billingengine-mcp": {
"command": "npx",
"args": [
"-y",
"billingengine-mcp"
],
"env": {
"BILLINGENGINE_API_KEY": "<YOUR_BILLINGENGINE_API_KEY>"
}
}
}
}Herramientas de BillingEngine MCP 10
Detectado desde el 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 | — |
Configuración
BILLINGENGINE_API_KEYObligatorioSecretoAPI key from Settings > API keys in BillingEngine (paid plans only)
| Nombre | Descripción | Tipo |
|---|---|---|
| BILLINGENGINE_API_KEY | API key from Settings > API keys in BillingEngine (paid plans only) | ObligatorioSecreto |
Verificaciones automáticas
Ejecutado 12 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesibleAprobado
- Licencia de código abierto (OSI)Aprobado
- Commit o lanzamiento en el último añoAprobado
- El nombre del paquete no es similar a un paquete popularAprobado
- El endpoint remoto usa HTTPSNo verificado
- Las herramientas destructivas están etiquetadasAprobado
- Sin instrucciones ocultas para el modeloAprobado
- No hay avisos críticos en el paquete ni en sus dependenciasAprobado
README
Ver en 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.
Preguntas sobre BillingEngine MCP
¿Cómo agrego BillingEngine MCP a Claude Code?
Ejecuta claude mcp add --env 'BILLINGENGINE_API_KEY=<YOUR_BILLINGENGINE_API_KEY>' billingengine-mcp -- npx -y billingengine-mcp en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego BillingEngine MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Qué herramientas proporciona BillingEngine MCP?
Expone 10 herramientas, incluidas find_customers, create_customer, update_customer, create_invoice, update_invoice.
¿Puedo enviar facturas directamente a los clientes usando este servidor?
No, las facturas se crean como borradores para que las revises y envíes manualmente dentro de BillingEngine.
¿Es posible eliminar registros a través del MCP server?
No, el servidor no admite operaciones de eliminación.
¿Cuáles son los límites de tasa de la API?
La API permite 60 solicitudes por minuto por cada API key.
¿El plan gratuito es compatible con este servidor?
No, necesitas un plan de pago porque la API no está disponible en el plan gratuito.