voxfactura-mcp
voxfactura-mcp lets an MCP client query and act on VoxFactura business data through scoped API tools.
List unpaid invoices, filter invoices, view invoice details, and download Factur-X PDFs.
List expenses and their attachments, and download attachment files.
List/search clients and compute client margin from billed HT, expenses, and margin.
Use legacy chantier tools and compute margin by chantier.
Get VAT recaps, sales/purchase journals, CSV journals, and FEC exports.
List receipts/payments for a period.
Create draft quotes; drafts are never sent automatically.
Mark invoices paid, including partial payments, and add expenses.
With a cabinet key, list accessible client dossiers and read/query one dossier at a time via the
dossierparameter; cabinet keys cannot write.All capabilities depend on the permissions granted to the API key.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@voxfactura-mcp Quelles sont mes factures impayées ?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
voxfactura-mcp
Branche ton business VoxFactura sur ton assistant IA (Claude Desktop, Claude Code, ou tout client MCP). Tu poses tes questions en langage naturel :
« Quelles sont mes factures impayées ? »
« Quelle est ma marge avec le client Martin ? »
« Combien j'ai dépensé chez Point P ce mois-ci ? »
« Donne-moi mon récapitulatif TVA du 1er trimestre. »
« Crée un devis brouillon pour le client 12 : 3 radiateurs à 450. »
L'assistant consulte tes données et peut préparer des brouillons ; il ne n'envoie jamais rien à un client (l'envoi reste une validation humaine dans VoxFactura). Tout passe par une clé API scopée que tu contrôles.
1. Crée une clé API
Dans VoxFactura : Réglages → Clés API → Créer une clé. Coche les permissions
voulues (lecture : factures, dépenses, clients, comptabilité, encaissements ;
écriture : créer des devis, marquer payé, ajouter des dépenses). Copie la clé
vf_live_… : elle n'est affichée qu'une seule fois.
Pour la marge d'un client : factures + dépenses.
La case « Chantiers et regroupements (ancien) » ne sert plus qu'aux outils chantiers, gardés pour compatibilité.
Pour le récap TVA / FEC : comptabilité.
Related MCP server: @centry-digital/bukku-mcp
2. Installe
pip install voxfactura-mcp
# ou, sans installer : uvx voxfactura-mcp3. Configure ton client MCP
Claude Desktop
Réglages → Développeur → Modifier la config :
{
"mcpServers": {
"voxfactura": {
"command": "voxfactura-mcp",
"env": { "VOXFACTURA_API_KEY": "vf_live_ta_cle_ici" }
}
}
}Redémarre Claude Desktop.
Claude Code
claude mcp add voxfactura -e VOXFACTURA_API_KEY=vf_live_ta_cle -- voxfactura-mcpVariables d'environnement
Variable | Rôle | Défaut |
| Ta clé API (obligatoire) | aucune |
| URL de l'API |
|
| Clé cabinet : numéro du dossier client lu par défaut | aucun |
Cabinet comptable : une clé pour tous vos dossiers
Un cabinet d'expertise comptable crée une clé cabinet (vf_cab_…) depuis
son espace cabinet VoxFactura, page API. Elle lit, en lecture seule, les
dossiers des clients qui vous ont donné accès, un dossier à la fois :
l'outil
dossiersliste vos dossiers (numéro, raison sociale, SIREN) ;chaque outil accepte un paramètre
dossier(numéro du dossier) ; à défaut, le serveur prendVOXFACTURA_DOSSIER;les outils d'écriture répondent par un refus : une clé cabinet ne modifie rien ;
chaque lecture figure dans le journal que voit votre client, qui peut retirer l'accès à tout moment.
{
"mcpServers": {
"voxfactura-cabinet": {
"command": "voxfactura-mcp",
"env": { "VOXFACTURA_API_KEY": "vf_cab_votre_cle", "VOXFACTURA_DOSSIER": "1" }
}
}
}Outils
Outil | Rôle | Permission |
| Dossiers clients d'une clé cabinet | clé cabinet |
| Factures impayées | factures |
| Factures (filtres statut / chantier / période) | factures |
| Détail d'une facture | factures |
| PDF Factur-X d'une facture émise (base64) | factures |
| Dépenses avec leur client, devis et facture (filtres client / chantier / catégorie / période) | dépenses |
| Justificatifs d'une dépense | dépenses |
| Fichier d'un justificatif (base64) | dépenses |
| Liste / recherche clients | clients |
| Facturé HT, dépenses et marge d'un client, par travail | factures + dépenses |
| Liste des chantiers (ancien regroupement) | chantiers |
| Détail d'un chantier (ancien regroupement) | chantiers |
| Ancien : CA facturé − dépenses d'un chantier, préférer | factures + dépenses |
| TVA collectée / déductible / nette | comptabilité |
| Journal des ventes d'une période | comptabilité |
| Journal des achats d'une période | comptabilité |
| Journal des ventes en CSV | comptabilité |
| Journal des achats en CSV | comptabilité |
| Fichier des écritures comptables de l'année | comptabilité |
| Factures encaissées d'une période (date, montant, moyen) | payments:read |
| Crée un devis (brouillon) | devis:write |
| Modèles de devis du compte et leurs variables | devis:write |
| Crée un devis (brouillon) depuis un modèle | devis:write |
| Marque une facture payée | payments:write |
| Ajoute une dépense | expenses:write |
Tous les outils (sauf dossiers) acceptent aussi dossier, utile seulement
avec une clé cabinet.
API sous-jacente
Le serveur n'est qu'un habillage de l'API publique VoxFactura (lecture/écriture
scopée). Doc interactive : https://api.voxfactura.com/api/v1/pub/docs.
Voir aussi llms.txt et examples/.
Éditeur
VoxFactura est édité par ASTERIO 37, SAS immatriculée au RCS de Paris (SIREN 107 559 619), 231 rue Saint-Honoré, 75001 Paris. Données hébergées dans l'Union européenne. Site : https://www.voxfactura.com. Contact : contact@voxfactura.com. Mentions légales : https://www.voxfactura.com/legal/mentions-legales.
La facture électronique passe par une plateforme agréée par l'administration fiscale : VoxFactura n'est pas elle-même plateforme agréée.
Licence
MIT.
Available Tools
25 toolsajouter_depenseC
Ajoute une dépense (permission expenses:write). Montants en texte (ex. « 240.00 »). Rattache à un chantier via chantier_id (numéro du chantier dans le compte).
Inputs: designation (required), montant_ttc (required), dossier, categorie, +4 more.
chantierC
Détail d'un chantier (ancien regroupement) par son numéro dans le
compte (le champ id renvoyé par la liste des chantiers).
Inputs: chantier_id (required), dossier.
chantiersA
Liste les chantiers (ancien regroupement, gardé pour compatibilité),
éventuellement filtrés par statut (en_cours, termine…) ou par client
(client_id = numéro du client dans le compte). Pour la marge, préférer
marge_client.
Inputs: statut, dossier, client_id.
clientsC
Liste les clients, avec une recherche textuelle optionnelle.
Inputs: dossier, recherche.
creer_devis_brouillonA
Crée un devis en BROUILLON (permission devis:write). client_id et
chantier_id sont les numéros du client et du chantier dans le compte.
Chaque ligne : {designation, quantite, unite, prix_unitaire_ht, taux_tva},
plus en option prestation_id (numéro de la prestation du catalogue ; prix
omis, la ligne prend le prix de ce client, sinon celui du catalogue) et
nature (« bien » pour une vente, « service » sinon ; omise, elle suit la
prestation du catalogue puis le réglage du compte).
validite_jours : durée de validité (omis = celle réglée sur le compte,
30 jours par défaut). delai_execution : délai imprimé sur le devis
(ex. « 3 semaines après acceptation »). Le devis n'est jamais envoyé
automatiquement : l'artisan le relit et l'envoie dans VoxFactura. Son
numero est nul tant qu'il est brouillon : le numéro définitif lui est
attribué à l'envoi.
Inputs: lignes (required), client_id (required), notes, objet, +4 more.
depensesB
Liste les dépenses (factures de frais). Chacune dit à quel client, devis
ou facture elle est rattachée (client_id, devis_id, facture_id,
numéros du compte). Filtrables par client (client_id = numéro du client
dans le compte), par chantier (numéro du chantier, ancien regroupement),
catégorie ou période (debut / fin en AAAA-MM-JJ, inclus).
Inputs: fin, debut, dossier, categorie, +2 more.
devis_depuis_modeleA
Crée un devis en BROUILLON depuis un modèle de devis (permission
devis:write). modele : nom ou numéro du modèle (voir modeles_devis).
variables : valeur de chaque variable sous son nom, dates en
AAAA-MM-JJ. client_id : numéro du client dans le compte, sinon celui
du modèle. Jamais envoyé automatiquement : l'artisan le relit et
l'envoie dans VoxFactura.
Inputs: modele (required), dossier, client_id, variables.
dossiersA
Clé cabinet seulement : les dossiers clients accessibles (numéro,
raison sociale, SIREN). Passez ensuite ce numéro dans le paramètre
dossier des autres outils (ou dans VOXFACTURA_DOSSIER).
Inputs: no named parameters.
encaissementsB
Factures encaissées sur une période (dates AAAA-MM-JJ) : facture, date, montant, moyen (carte, virement, déclaré). Permission encaissements.
Inputs: fin, debut, limit, dossier.
export_fecC
Fichier des écritures comptables (FEC, texte tabulé) de l'année, à remettre à l'expert-comptable. Nécessite la permission comptabilité.
Inputs: annee (required), dossier.
factureB
Détail d'une facture (lignes comprises) par son numéro dans le compte
(le champ id renvoyé par la liste des factures).
Inputs: facture_id (required), dossier.
facturesB
Liste les factures émises, éventuellement filtrées par statut, chantier
(chantier_id = numéro du chantier dans le compte) ou période d'émission
(debut / fin en AAAA-MM-JJ, inclus).
Inputs: fin, debut, limit, statut, +2 more.
factures_impayeesB
Liste les factures impayées (envoyées, partiellement payées, en retard).
Inputs: dossier.
journal_achatsA
Journal des achats sur une période (dates AAAA-MM-JJ) : une écriture par dépense. Nécessite la permission comptabilité.
Inputs: fin (required), debut (required), dossier.
journal_achats_csvC
Journal des achats en CSV (séparateur « ; », montants à virgule). Permission comptabilité.
Inputs: fin (required), debut (required), dossier.
journal_ventesB
Journal des ventes sur une période (dates AAAA-MM-JJ) : une écriture par facture et avoir. Nécessite la permission comptabilité.
Inputs: fin (required), debut (required), dossier.
journal_ventes_csvB
Journal des ventes en CSV (séparateur « ; », montants à virgule), tel que l'importe un logiciel de compta français. Permission comptabilité.
Inputs: fin (required), debut (required), dossier.
justificatifB
Télécharge un justificatif d'une dépense (depense_id = numéro de la
dépense dans le compte, justificatif_id = le champ id de
justificatifs_depense), en base64 avec son type.
Inputs: depense_id (required), justificatif_id (required), dossier.
justificatifs_depenseB
Liste les justificatifs (photo de ticket, PDF) d'une dépense, par son numéro dans le compte : id, nom, type, taille.
Inputs: depense_id (required), dossier.
marge_chantierA
Ancien regroupement, gardé pour compatibilité : préférer marge_client.
Marge d'un chantier (par son numéro dans le compte) : chiffre d'affaires
facturé moins les dépenses rangées sur ce chantier. Nécessite une clé avec
les permissions factures + dépenses.
Inputs: chantier_id (required), dossier.
marge_clientA
Marge d'un client (client_id = numéro du client dans le compte, le
champ id de l'outil clients) : facturé HT, dépenses et marge, en tout et
par travail (un devis et ses factures, une facture seule, ou un
regroupement), plus une ligne sans_document pour les dépenses du client
sans devis ni facture. Mêmes chiffres que la fiche client de VoxFactura ;
depenses_en_ttc vrai pour un compte en franchise de TVA. Nécessite une
clé avec les permissions factures + dépenses.
Inputs: client_id (required), dossier.
marquer_facture_payeeB
Marque une facture payée (permission payments:write). facture_id =
numéro de la facture dans le compte. montant (texte,
ex. « 500.00 ») pour un paiement partiel ; vide = solde le total.
Inputs: facture_id (required), dossier, montant.
modeles_devisB
Modèles de devis de l'artisan (permission devis:write) : numéro, nom,
objet et variables à remplir pour devis_depuis_modele.
Inputs: dossier.
pdf_factureB
PDF Factur-X d'une facture émise (par son numéro dans le compte), en base64 avec son nom de fichier. Un brouillon n'a pas de PDF.
Inputs: facture_id (required), dossier.
recap_tvaB
Récapitulatif TVA sur une période (dates AAAA-MM-JJ) : collectée, déductible, TVA nette. Nécessite la permission comptabilité.
Inputs: fin (required), debut (required), dossier.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 25 tools
Several tools overlap: factures_impayees is a subset of factures with a status filter, journal_ventes_csv/journal_achats_csv duplicate the non-CSV journals with a different format, and legacy chantier/marge_chantier plus justificatif/justificatifs_depense can cause misselection. Descriptions often clarify intended use, but there is more than one or two ambiguous boundary.
All names are snake_case and mostly French/domain-specific, with a generally predictable pattern of plural nouns for lists and verb_noun for writes. There are minor deviations such as devis_depuis_modele and export_fec, but the convention remains readable.
25 tools is heavy for the apparent scope and includes redundant format variants and legacy compatibility tools that could be consolidated. The domain is broad—quotes, invoices, expenses, accounting, and cabinet access—so it is not an extreme mismatch, but it sits at the borderline.
Coverage is strong for listing clients, chantiers, invoices, expenses, accounting journals, TVA, FEC, and draft quote/expense creation. However, there is no devis list/detail after draft creation and no client or chantier creation/update, leaving some workflows with dead ends.
Maintenance
Related MCP Connectors
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
MCP server for Quaderno — tax-rate calculation, invoices, contacts, products, receipts & expenses.
MCP server that lets AI assistants use all OneSchema features exposed via the public API.
MCP server for Codat — companies, connections, invoices, bills and financial statements.
Related MCP Servers
- AlicenseBqualityDmaintenanceMCP server for Invoice Ninja v5 API. Enables AI assistants to manage clients, invoices, quotes, payments, and time tracking through natural language.3222 npm2MIT
- AlicenseNot gradedqualityAmaintenanceMCP server enabling AI assistants to manage invoices, contacts, products, and other accounting data through the Bukku API.9MIT
- AlicenseAqualityCmaintenanceMCP server for Spanish accounting for freelancers and SMEs, enabling AI agents to issue invoices, OCR expense PDFs, reconcile bank transactions, and prepare quarterly VAT (Modelo 303).234MIT
- FlicenseNot gradedqualityDmaintenanceMulti-tenant MCP server connecting accounting software to AI assistants via ~87 tools. Supports Bokio (Swedish accounting) with mock mode for development.-