Permet aux clients IA de gérer les clients, de créer des brouillons de factures, de lister les factures et d'enregistrer les paiements via l'API BillingEngine.
Aussi connu sous billingengine/billingengine-mcp, billingengine-mcp
- Étoiles
- 0
- Outils
- 10
- Téléchargements, 30 jours
- 841
- Dernière version
- 0.2.2
- Dernier commit
- 6 nov. 2026
- Licence
- MIT
Qu'est-ce que BillingEngine MCP ?
Permet aux clients IA de gérer les clients, de créer des brouillons de factures, de lister les factures et d'enregistrer les paiements via l'API BillingEngine. Il expose 10 outils, comme find_customers, create_customer, update_customer.
Résumé généré à partir du README du projet
À propos du MCP server BillingEngine
Ce serveur permet aux freelances et aux propriétaires de petites entreprises de gérer les dossiers clients et les documents financiers via une interface IA. En se connectant à l'API BillingEngine, les utilisateurs peuvent interagir avec leur logiciel de facturation en langage naturel via des clients comme Claude Desktop, Cursor ou Claude Code. Le serveur s'exécute localement sur votre ordinateur avec Node.js 20 ou une version ultérieure et nécessite un compte BillingEngine payant ainsi qu'une clé API valide pour fonctionner.
Les utilisateurs peuvent effectuer plusieurs tâches administratives, notamment la recherche de clients avec find_customers, la création de brouillons de factures et l'énumération des factures existantes avec des filtres spécifiques. L'ensemble d'outils permet également d'enregistrer des paiements et de télécharger des factures électroniques au format PDF ou XML directement dans votre dossier Téléchargements. Comme le serveur ne crée que des brouillons de factures, aucun document n'est envoyé automatiquement aux clients, ce qui vous permet de vérifier chaque entrée avant la finalisation. Le système est soumis à une limite de 60 requêtes par minute par clé API.
Ce que vous pouvez faire avec
- 1Générer de nouveaux brouillons de facturationDemandez à l'IA de créer un nouveau brouillon de facture pour un client et un montant spécifiques.
- 2Suivre les paiements en attenteIdentifiez quels clients ont des factures impayées en interrogeant le système.
- 3Enregistrer les fonds reçusDites à l'IA d'enregistrer un paiement pour un numéro de facture spécifique.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer BillingEngine MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller BillingEngine MCP dans Claude Code
$ claude mcp add --env 'BILLINGENGINE_API_KEY=<YOUR_BILLINGENGINE_API_KEY>' billingengine-mcp -- npx -y billingengine-mcpInstaller BillingEngine MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"billingengine-mcp": {
"command": "npx",
"args": [
"-y",
"billingengine-mcp"
],
"env": {
"BILLINGENGINE_API_KEY": "<YOUR_BILLINGENGINE_API_KEY>"
}
}
}
}Installer BillingEngine MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"billingengine-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"billingengine-mcp"
],
"env": {
"BILLINGENGINE_API_KEY": "<YOUR_BILLINGENGINE_API_KEY>"
}
}
}
}Installer BillingEngine MCP dans 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>"}}'Installer BillingEngine MCP dans Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"billingengine-mcp": {
"command": "npx",
"args": [
"-y",
"billingengine-mcp"
],
"env": {
"BILLINGENGINE_API_KEY": "<YOUR_BILLINGENGINE_API_KEY>"
}
}
}
}Installer BillingEngine MCP dans Codex
$ codex mcp add billingengine-mcp --env 'BILLINGENGINE_API_KEY=<YOUR_BILLINGENGINE_API_KEY>' -- npx -y billingengine-mcpInstaller BillingEngine MCP dans 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>"
Installer BillingEngine MCP dans Gemini CLI
$ gemini mcp add -s user -e 'BILLINGENGINE_API_KEY=<YOUR_BILLINGENGINE_API_KEY>' billingengine-mcp npx -- -y billingengine-mcpInstaller BillingEngine MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"billingengine-mcp": {
"command": "npx",
"args": [
"-y",
"billingengine-mcp"
],
"env": {
"BILLINGENGINE_API_KEY": "<YOUR_BILLINGENGINE_API_KEY>"
}
}
}
}Une clé est requise avant le démarrage
Démarré le 16 nov. 2026 sans clé, il s'est arrêté et en a demandé une : un client ne voit donc aucun outil tant que les variables ci-dessus ne sont pas définies.
Outils MCP BillingEngine 10
Détectés depuis le 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 | — |
Configuration
BILLINGENGINE_API_KEYRequisSecretAPI key from Settings > API keys in BillingEngine (paid plans only)
| Nom | Description | Type |
|---|---|---|
| BILLINGENGINE_API_KEY | API key from Settings > API keys in BillingEngine (paid plans only) | RequisSecret |
Vérifications automatisées
Exécuté le 12 nov. 2026Rapport complet →A passé nos vérifications automatisées. Il ne s'agit pas d'un audit de sécurité : lisez le code et donnez au serveur l'accès le plus restreint dont il a besoin. Fonctionnement des vérifications
- Dépôt source lié et accessibleRéussi
- Licence open source (OSI)Réussi
- Commit ou version publiée au cours de l'année écouléeRéussi
- Nom du package non proche d'un package populaireRéussi
- L'endpoint distant utilise HTTPSNon vérifié
- Les outils destructifs sont étiquetésRéussi
- Aucune instruction cachée destinée au modèleRéussi
- Aucun avis critique dans le package ou ses dépendancesRéussi
README
Voir sur 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.
Questions sur BillingEngine MCP
Comment ajouter BillingEngine MCP à Claude Code ?
Exécutez claude mcp add --env 'BILLINGENGINE_API_KEY=<YOUR_BILLINGENGINE_API_KEY>' billingengine-mcp -- npx -y billingengine-mcp dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter BillingEngine MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Quels outils BillingEngine MCP fournit-il ?
Il expose 10 outils, dont find_customers, create_customer, update_customer, create_invoice, update_invoice.
Puis-je envoyer des factures directement aux clients en utilisant ce serveur ?
Non, les factures sont créées sous forme de brouillons pour que vous puissiez les examiner et les envoyer manuellement dans BillingEngine.
Est-il possible de supprimer des enregistrements via le serveur MCP ?
Non, le serveur ne prend en charge aucune opération de suppression.
Quelles sont les limites de débit de l'API ?
L'API autorise 60 requêtes par minute par clé API.
Le forfait gratuit prend-il en charge ce serveur ?
Non, vous devez disposer d'un forfait payant car l'API n'est pas disponible avec le forfait Free.