pennylane-mcp-server
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., "@pennylane-mcp-server quelles factures clients sont en retard ?"
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.
pennylane-mcp-claude
Votre comptabilité Pennylane, interrogée en français depuis Claude.
Vous installez ce serveur vous-même, avec votre propre jeton Pennylane. Aucun intermédiaire ne s'ajoute entre Claude, votre machine et Pennylane.
1. Ce que c'est
Pennylane a une API complète, mais elle ne se parle qu'en requêtes HTTP : pagination par curseur, filtres en JSON, un jeton par dossier. Ce serveur la traduit en 87 outils MCP que Claude appelle tout seul. Vous demandez « quelles factures clients sont en retard ? », et Claude interroge Pennylane, trie et répond.
Les outils couvrent la balance, les écritures, le lettrage, les journaux, les clients, les fournisseurs, les factures, les devis, les produits, les abonnements et les exports FEC. Ils lisent et ils écrivent : Claude peut créer une facture ou marquer un paiement.
Ce dépôt est un fork de melvynx/pennylane-mcp-server (MIT, Melvyn Morice), qui a écrit les outils métier. Le fork ajoute trois choses :
Ajout | Ce que ça change pour vous |
OAuth embarqué et transport HTTP ( | Le serveur se branche sur claude.ai web et mobile, protégé par un mot de passe |
Factures lisibles ( | « Impayées », « en retard avant le 15 », « émises en septembre » s'obtiennent en un appel. Le filtre |
Déploiement ( | Un serveur public avec HTTPS automatique, en une commande |
Pennylane propose aussi son propre connecteur MCP ; celui-ci s'en distingue par ses outils d'écriture et par le travail sur les factures, et le choix entre les deux dépend de votre usage.
La documentation amont (référence outil par outil, notions comptables) se trouve dans docs/.
Related MCP server: MonKey Office MCP Server
2. Comment ça marche
Deux façons de l'utiliser, selon l'endroit où vous parlez à Claude.
EN LOCAL (Claude Desktop, Claude Code)
Claude ──stdio──▶ pennylane-mcp-server (sur votre ordinateur) ──HTTPS──▶ API Pennylane
SUR UN SERVEUR (claude.ai web et mobile)
claude.ai ──HTTPS──▶ Caddy (certificat auto) ──▶ conteneur pennylane-mcp ──HTTPS──▶ API Pennylane
│ OAuth embarqué : mot de passe à la connexion
└ volume /state : jetons de connexion conservésEn local, Claude Desktop lance le serveur lui-même et lui parle par l'entrée et la sortie standard. Rien n'est exposé sur Internet. C'est la voie la plus simple, mais elle ne marche que sur l'ordinateur où le serveur est installé.
Sur un serveur, claude.ai doit joindre votre serveur depuis Internet, en HTTPS. Le serveur embarque son propre serveur d'autorisation OAuth. La première fois que vous branchez le connecteur, claude.ai ouvre une page qui vous demande votre mot de passe. claude.ai reçoit ensuite des jetons de connexion, que le serveur conserve sur disque : un redémarrage ne vous déconnecte pas.
3. Comment l'utiliser
Prérequis : un jeton Pennylane
Dans Pennylane : Paramètres → Connectivité → Développeurs, puis créez un Company API Token. Cochez au minimum ces droits :
ledger_accounts:all, journals:all, ledger_entries:all, trial_balance:readonly, fiscal_years:readonly, customers:all, customer_invoices:all, supplier_invoices:all
Fournisseurs, produits, devis, catégories, abonnements et exports ont leurs propres droits dans la même page : cochez ceux des outils que vous comptez utiliser. Un outil qui répond 403 signale un droit manquant sur le jeton.
Ce jeton donne accès à toute la comptabilité du dossier. Traitez-le comme un mot de passe : jamais dans un mail, jamais dans un dépôt git.
Voie A : en local, avec Claude Desktop
Ouvrez un terminal. Sur macOS : ⌘ + Espace, tapez « Terminal », Entrée. Sur Windows : menu Démarrer, « PowerShell ».
Installez uv, qui télécharge et lance le serveur pour vous.
macOS ou Linux :
curl -LsSf https://astral.sh/uv/install.sh | shWindows :
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
Fermez le terminal et ouvrez-en un nouveau, sinon la commande
uvxreste introuvable. Testez ensuite le téléchargement du serveur :uvx --from git+https://github.com/Matthieusabourin2/pennylane-mcp-claude python -c "import pennylane_mcp; print('ok')"okdoit s'afficher. Sur un Mac qui n'a jamais servi au développement, macOS propose d'abord d'installer les « outils de ligne de commande » (git en fait partie) : acceptez, puis relancez la commande.Trouvez le chemin complet de
uvx:which uvxsur macOS (souvent/Users/VOTRENOM/.local/bin/uvx),where uvxsur Windows. Claude Desktop ne connaît pas votrePATH, d'où le chemin complet.Dans Claude Desktop : Paramètres → Développeur → Modifier la configuration. Le Finder (ou l'Explorateur) montre le fichier
claude_desktop_config.json: ouvrez-le avec un éditeur de texte brut. Avec TextEdit, passez d'abord par Format → Convertir au format texte, sinon les guillemets deviennent typographiques et le fichier ne se lit plus. Si le fichier est vide ou contient{}, remplacez tout par le bloc ci-dessous. S'il contient déjà d'autres réglages, ajoutez seulement l'entrée"pennylane"dans"mcpServers"(ou la clé"mcpServers"entière si elle manque), en gardant une virgule entre deux entrées.{ "mcpServers": { "pennylane": { "command": "/chemin/complet/vers/uvx", "args": ["--from", "git+https://github.com/Matthieusabourin2/pennylane-mcp-claude", "pennylane-mcp-server"], "env": { "PENNYLANE_API_TOKEN": "votre-jeton-pennylane" } } } }Quittez complètement Claude Desktop (⌘ + Q sur macOS), puis relancez-le. Demandez : « Liste mes factures clients en retard. »
Avec Claude Code, une seule commande suffit (-s user rend le serveur disponible dans tous vos projets) :
claude mcp add -s user pennylane -e PENNYLANE_API_TOKEN=votre-jeton -- uvx --from git+https://github.com/Matthieusabourin2/pennylane-mcp-claude pennylane-mcp-serverVoie B : sur un serveur, pour claude.ai web et mobile
Il vous faut une machine joignable depuis Internet (un VPS, une VM chez Scaleway, OVH ou ailleurs, ou un serveur chez vous) et un nom de domaine. Le guide pas à pas est dans docs/deploiement-serveur.md. En résumé :
git clone https://github.com/Matthieusabourin2/pennylane-mcp-claude.git
cd pennylane-mcp-claude
cp .env.example .env # puis remplir : jeton Pennylane, domaine, mot de passe
docker compose up -d --buildPuis, dans claude.ai : Paramètres → Connecteurs → Ajouter un connecteur personnalisé. Les connecteurs personnalisés dépendent de votre offre Claude ; sur une offre Team ou Enterprise, c'est un propriétaire de l'organisation qui les ajoute.
URL :
https://votre-domaine/mcpDans les paramètres avancés, choisissez « Utiliser votre propre client OAuth ». L'identifiant client est libre (par exemple
claude-pennylane), et le secret client reste vide. Les deux autres choix échouent : ce serveur n'accepte pas l'enregistrement automatique des clients.Une page « pennylane-mcp » s'ouvre : saisissez la valeur de
MCP_BEARER_TOKEN(ou deMCP_OAUTH_PASSWORD, si vous l'avez définie).
Le connecteur apparaît ensuite aussi dans l'application mobile Claude.
Sécurité, à lire avant d'exposer le serveur
Le mot de passe est la seule barrière entre Internet et votre comptabilité, en écriture. Générez-le avec
openssl rand -base64 32et ne le réutilisez nulle part. Le serveur ne limite pas les tentatives : un mot de passe court se devine.Changer le mot de passe ne déconnecte pas les sessions déjà ouvertes : leurs jetons de rafraîchissement restent valides. En cas de fuite, changez-le dans
.env, puis effacez les jetons et redémarrez :docker compose down,docker volume rm pennylane-mcp-claude_oauth-state(le préfixe est le nom du dossier),docker compose up -d. Rebranchez ensuite le connecteur dans claude.ai.Le serveur refuse de démarrer si l'OAuth est activé sans mot de passe ou sans adresse publique HTTPS. Il refuse aussi de renvoyer un code d'autorisation ailleurs que vers claude.ai.
.envetdossiers.jsonsont exclus du dépôt git et de l'image Docker. Gardez-les ainsi.
Limites connues
Au-delà d'environ 58 factures en mode compact, la réponse dépasse la taille qu'un outil peut renvoyer et elle est tronquée. Les compteurs (
count,is_complete) restent en tête. Resserrez alors la période ou filtrez par client.pennylane_get_quoteet les outils d'écriture renvoient encorepublic_file_url. Chaque lecture de ce champ régénère le lien public du PDF et invalide le précédent.Plusieurs dossiers Pennylane sur un même serveur : c'est possible avec un fichier
dossiers.json(voirdocs/deploiement-serveur.md). Toute personne qui connaît le mot de passe accède alors à tous les dossiers.
Développer
pip install -e .
python -m unittest discover -s tests # tests des fonctions pures, sans jetonLicence
MIT. La licence d'origine de Melvyn Morice est conservée dans LICENSE.
Available Tools
87 toolspennylane_add_dossierA
Ajoute un nouveau dossier comptable à la configuration. Le token est vérifié avec l'endpoint /me avant l'ajout. Si c'est le premier dossier, il devient automatiquement actif.
Inputs: name (required), slug (required), token (required), notes. Returns: result
pennylane_changelog_customer_invoicesDRead-onlyIdempotent
Inputs: sort, limit, cursor. Returns: result
pennylane_changelog_customersDRead-onlyIdempotent
Inputs: sort, limit, cursor. Returns: result
pennylane_changelog_entry_linesDRead-onlyIdempotent
Inputs: sort, limit, cursor. Returns: result
pennylane_changelog_productsDRead-onlyIdempotent
Inputs: sort, limit, cursor. Returns: result
pennylane_changelog_quotesDRead-onlyIdempotent
Inputs: sort, limit, cursor. Returns: result
pennylane_changelog_supplier_invoicesDRead-onlyIdempotent
Inputs: sort, limit, cursor. Returns: result
pennylane_changelog_suppliersDRead-onlyIdempotent
Inputs: sort, limit, cursor. Returns: result
pennylane_changelog_transactionsDRead-onlyIdempotent
Inputs: sort, limit, cursor. Returns: result
pennylane_create_accountA
Crée un nouveau compte dans le plan comptable. Un numéro commençant par 401 crée automatiquement un fournisseur, par 411 un client.
Inputs: label (required), number (required), vat_rate, country_alpha2. Returns: result
pennylane_create_agl_exportA
Crée un export Grand Livre Analytique (AGL) pour une période. L'export est asynchrone : utilisez pennylane_get_agl_export pour récupérer le fichier.
Inputs: period_end (required), period_start (required), mode. Returns: result
pennylane_create_billing_subscriptionB
Crée un nouvel abonnement de facturation récurrente. Nécessite un client, une date de début, une règle de récurrence et des lignes.
Inputs: start (required), customer_id (required), invoice_lines (required), payment_method (required), +4 more. Returns: result
pennylane_create_categoryB
Crée une nouvelle catégorie analytique dans un groupe. Le libellé et l'ID de groupe sont obligatoires.
Inputs: label (required), category_group_id (required), direction, analytical_code. Returns: result
pennylane_create_company_customerA
Crée un nouveau client de type entreprise (société). Le nom (raison sociale) est obligatoire.
Inputs: name (required), city, notes, phone, +7 more. Returns: result
pennylane_create_customer_invoiceA
Crée une nouvelle facture client (brouillon par défaut). Nécessite un client, une date, une échéance et au moins une ligne.
Inputs: date (required), deadline (required), customer_id (required), invoice_lines (required), +3 more. Returns: result
pennylane_create_entryB
Crée une nouvelle écriture comptable avec ses lignes. RÈGLE FONDAMENTALE : total débits = total crédits. Les montants sont des strings (ex: '1500.00').
Inputs: date (required), label (required), journal_id (required), ledger_entry_lines (required), +3 more. Returns: result
pennylane_create_fec_exportA
Crée un export FEC (Fichier des Écritures Comptables) pour une période. L'export est asynchrone : utilisez pennylane_get_fec_export pour récupérer le fichier une fois le statut 'ready'.
Inputs: period_end (required), period_start (required). Returns: result
pennylane_create_individual_customerA
Crée un nouveau client de type particulier (personne physique). Le prénom et le nom sont obligatoires.
Inputs: last_name (required), first_name (required), city, notes, +6 more. Returns: result
pennylane_create_journalB
Crée un nouveau journal comptable. Codes classiques : VE (ventes), HA (achats), BQ (banque), OD (opérations diverses), PA (paie), RB (reprise de balance).
Inputs: code (required), label (required). Returns: result
pennylane_create_productB
Crée un nouveau produit/service dans le catalogue. Le libellé, le prix HT et le taux de TVA sont obligatoires.
Inputs: label (required), vat_rate (required), price_before_tax (required), unit, +4 more. Returns: result
pennylane_create_quoteB
Crée un nouveau devis. Nécessite un client, une date, une échéance et au moins une ligne.
Inputs: date (required), deadline (required), customer_id (required), invoice_lines (required), +5 more. Returns: result
pennylane_create_supplierC
Crée un nouveau fournisseur. Le nom est obligatoire.
Inputs: name (required), city, iban, emails, +7 more. Returns: result
pennylane_current_dossierARead-onlyIdempotent
Affiche le dossier comptable actuellement actif avec les informations de connexion Pennylane (via /me).
Inputs: no named parameters. Returns: result
pennylane_finalize_customer_invoiceA
Transforme un brouillon de facture client en facture finalisée. Attention : cette action est irréversible. La facture reçoit un numéro définitif.
Inputs: id (required). Returns: result
pennylane_get_accountARead-onlyIdempotent
Récupère le détail d'un compte comptable par son identifiant.
Inputs: id (required). Returns: result
pennylane_get_agl_exportARead-onlyIdempotent
Récupère le détail d'un export Grand Livre Analytique. Retourne le statut et l'URL de téléchargement si prêt.
Inputs: id (required). Returns: result
pennylane_get_billing_subscriptionBRead-onlyIdempotent
Récupère le détail complet d'un abonnement de facturation.
Inputs: id (required). Returns: result
pennylane_get_categoryBRead-onlyIdempotent
Récupère le détail d'une catégorie analytique par son identifiant.
Inputs: id (required). Returns: result
pennylane_get_category_groupBRead-onlyIdempotent
Récupère le détail d'un groupe de catégories par son identifiant.
Inputs: id (required). Returns: result
pennylane_get_customerARead-onlyIdempotent
Récupère le détail d'un client par son identifiant. Retourne les informations complètes (adresse, contacts, conditions de paiement).
Inputs: id (required). Returns: result
pennylane_get_customer_invoiceARead-onlyIdempotent
Récupère le détail complet d'une facture client par son identifiant, en un appel.
Les lignes (invoice_lines), les paiements (payments) et les transactions
bancaires rapprochées (matched_transactions) sont intégrés, au lieu de leurs URL.
Listes payments et matched_transactions vides = facture non rapprochée dans
Pennylane ; pour savoir si l'argent est arrivé, voir Qonto.
Inputs: id (required). Returns: result
pennylane_get_entryBRead-onlyIdempotent
Récupère le détail complet d'une écriture comptable avec toutes ses lignes.
Inputs: id (required). Returns: result
pennylane_get_entry_lineBRead-onlyIdempotent
Récupère le détail d'une ligne d'écriture comptable.
Inputs: id (required). Returns: result
pennylane_get_fec_exportARead-onlyIdempotent
Récupère le détail d'un export FEC. Retourne le statut (pending/ready/error) et l'URL de téléchargement si prêt (expire dans 10 minutes).
Inputs: id (required). Returns: result
pennylane_get_journalBRead-onlyIdempotent
Récupère le détail d'un journal comptable par son identifiant.
Inputs: id (required). Returns: result
pennylane_get_productARead-onlyIdempotent
Récupère le détail d'un produit par son identifiant. Retourne : libellé, prix HT, TVA, unité, compte comptable associé.
Inputs: id (required). Returns: result
pennylane_get_quoteARead-onlyIdempotent
Récupère le détail complet d'un devis par son identifiant. Retourne toutes les informations : montants, lignes, statut, client.
Inputs: id (required). Returns: result
pennylane_get_supplierARead-onlyIdempotent
Récupère le détail d'un fournisseur par son identifiant. Retourne les informations complètes (adresse, SIRET, IBAN, conditions de paiement).
Inputs: id (required). Returns: result
pennylane_get_supplier_invoiceARead-onlyIdempotent
Récupère le détail complet d'une facture fournisseur. Retourne toutes les informations : montants, lignes, statut, fournisseur.
Inputs: id (required). Returns: result
pennylane_get_trial_balanceARead-onlyIdempotent
Récupère la balance générale pour une période donnée. Retourne chaque compte avec ses totaux débit/crédit. Essentiel pour les travaux de clôture, la vérification des soldes, et la préparation des états financiers.
L'outil pagine automatiquement pour récupérer TOUS les comptes (classes 1 à 7) afin de garantir des totaux exacts.
Inputs: period_end (required), period_start (required), is_auxiliary. Returns: result
pennylane_letter_linesA
Lettre (rapproche) des lignes d'écriture entre elles. Permet de pointer des factures avec des règlements. Les lignes doivent appartenir au même compte (ex: 411xxx client). Par défaut, débit total = crédit total.
Inputs: line_ids (required), allow_partial. Returns: result
pennylane_link_categoriesBIdempotent
Associe des catégories analytiques à une ligne d'écriture. Chaque catégorie a un poids (0 à 1, somme = 1).
Inputs: line_id (required), categories (required). Returns: result
pennylane_list_accountsARead-onlyIdempotent
Liste les comptes du plan comptable avec filtres et pagination. Utile pour consulter le plan comptable, chercher un compte par préfixe (411=clients, 401=fournisseurs, 512=banque, 6=charges, 7=produits).
Inputs: sort, limit, cursor, enabled_only, +1 more. Returns: result
pennylane_list_all_entry_linesARead-onlyIdempotent
Liste toutes les lignes d'écriture comptable avec filtres par journal, compte et période. Utile pour analyser les mouvements d'un compte ou d'un journal sur une période.
Inputs: sort, limit, cursor, date_to, +3 more. Returns: result
pennylane_list_billing_subscriptionsARead-onlyIdempotent
Liste les abonnements de facturation récurrente avec filtres et pagination. Utile pour consulter les abonnements actifs, filtrer par client ou statut.
Inputs: sort, limit, cursor, status, +1 more. Returns: result
pennylane_list_categoriesARead-onlyIdempotent
Liste les catégories analytiques avec filtres et pagination. Utile pour consulter les axes analytiques disponibles.
Inputs: sort, limit, cursor, category_group_id. Returns: result
pennylane_list_category_groupsARead-onlyIdempotent
Liste tous les groupes de catégories analytiques. Chaque groupe contient des catégories utilisées pour la ventilation analytique.
Inputs: limit, cursor. Returns: result
pennylane_list_customer_invoice_linesCRead-onlyIdempotent
Liste les lignes (articles) d'une facture client spécifique.
Inputs: customer_invoice_id (required), limit, cursor. Returns: result
pennylane_list_customer_invoicesARead-onlyIdempotent
Liste les factures clients (et avoirs, montant négatif), en mode compact par défaut.
Filtré côté Pennylane : customer_id, date_from, date_to. L'API ne filtre ni par
statut, ni par échéance, ni par montant.
Filtré localement : status, unpaid_only, deadline_before. Dans ce cas l'outil pagine seul
(plafond 1 000 documents), renvoie toutes les correspondances et indique
is_complete ; limit et cursor sont ignorés.
« Payé » : le champ paid ne fait pas foi (les factures annulées ont paid=true).
Seuls status et remaining_amount_with_tax comptent. « Impayée » veut dire
« non rapprochée dans Pennylane » : pour savoir si l'argent est arrivé, voir Qonto.
Inputs: sort, limit, cursor, detail, +6 more. Returns: result
pennylane_list_customersARead-onlyIdempotent
Liste les clients (entreprises et particuliers) avec filtres et pagination. Utile pour consulter la base clients, rechercher un client par nom ou type.
Inputs: name, sort, limit, cursor, +1 more. Returns: result
pennylane_list_dossiersARead-onlyIdempotent
Liste tous les dossiers comptables configurés avec leur statut. Les tokens sont masqués pour la sécurité.
Inputs: no named parameters. Returns: result
pennylane_list_entriesBRead-onlyIdempotent
Liste les écritures comptables (pièces) avec filtres par journal et période. Chaque écriture contient des lignes équilibrées (débit = crédit).
Inputs: sort, limit, cursor, date_to, +2 more. Returns: result
pennylane_list_entry_linesCRead-onlyIdempotent
Liste les lignes d'écriture d'une pièce comptable spécifique.
Inputs: ledger_entry_id (required), limit, cursor. Returns: result
pennylane_list_fiscal_yearsARead-onlyIdempotent
Liste les exercices fiscaux avec leurs dates et statuts (open, closed, frozen). Utile pour connaître les périodes comptables.
Inputs: sort, limit, cursor. Returns: result
pennylane_list_group_categoriesBRead-onlyIdempotent
Liste les catégories appartenant à un groupe spécifique.
Inputs: category_group_id (required), limit, cursor. Returns: result
pennylane_list_journalsBRead-onlyIdempotent
Liste tous les journaux comptables (ventes, achats, banque, OD, paie...) avec filtres optionnels par type.
Inputs: sort, limit, cursor, type_filter. Returns: result
pennylane_list_lettered_linesARead-onlyIdempotent
Liste les lignes lettrées (rapprochées) avec une ligne donnée. Permet de voir quels règlements sont pointés avec quelles factures.
Inputs: line_id (required), limit, cursor. Returns: result
pennylane_list_line_categoriesBRead-onlyIdempotent
Liste les catégories analytiques associées à une ligne d'écriture.
Inputs: line_id (required), limit, cursor. Returns: result
pennylane_list_productsARead-onlyIdempotent
Liste les produits/services du catalogue avec filtres et pagination. Utile pour consulter le catalogue, rechercher un produit par nom.
Inputs: sort, label, limit, cursor. Returns: result
pennylane_list_quote_linesARead-onlyIdempotent
Liste les lignes (articles) d'un devis spécifique.
Inputs: quote_id (required), limit, cursor. Returns: result
pennylane_list_quotesARead-onlyIdempotent
Liste les devis avec filtres et pagination, en mode compact par défaut. Utile pour consulter les devis émis, filtrer par statut ou client.
Inputs: sort, limit, cursor, detail, +2 more. Returns: result
pennylane_list_quote_sectionsCRead-onlyIdempotent
Liste les sections de lignes d'un devis.
Inputs: quote_id (required), limit, cursor. Returns: result
pennylane_list_subscription_linesCRead-onlyIdempotent
Liste les lignes de facturation d'un abonnement.
Inputs: subscription_id (required), limit, cursor. Returns: result
pennylane_list_subscription_sectionsCRead-onlyIdempotent
Liste les sections de lignes d'un abonnement de facturation.
Inputs: subscription_id (required), limit, cursor. Returns: result
pennylane_list_supplier_invoice_linesARead-onlyIdempotent
Liste les lignes (articles) d'une facture fournisseur spécifique.
Inputs: supplier_invoice_id (required), limit, cursor. Returns: result
pennylane_list_supplier_invoicesBRead-onlyIdempotent
Liste les factures fournisseurs avec filtres et pagination. Utile pour consulter les factures reçues, filtrer par statut ou fournisseur.
Inputs: sort, limit, cursor, status, +1 more. Returns: result
pennylane_list_suppliersARead-onlyIdempotent
Liste les fournisseurs avec filtres et pagination. Utile pour consulter la base fournisseurs, rechercher un fournisseur par nom.
Inputs: name, sort, limit, cursor. Returns: result
pennylane_mark_customer_invoice_paidAIdempotent
Marque une facture client finalisée comme payée.
Inputs: id (required). Returns: result
pennylane_multi_dossier_queryARead-onlyIdempotent
Exécute une requête GET en parallèle sur plusieurs dossiers. Utile pour comparer des données entre clients ou consolider des informations (ex: balances, comptes, exercices).
Inputs: endpoint (required), dossier_slugs (required), params. Returns: result
pennylane_remove_dossierADestructive
Supprime un dossier comptable de la configuration. Si le dossier supprimé était actif, le premier dossier restant devient actif automatiquement.
Inputs: slug (required). Returns: result
pennylane_send_quote_by_emailB
Envoie un devis par email au client ou à des destinataires spécifiques.
Inputs: id (required), recipients. Returns: result
pennylane_switch_dossierAIdempotent
Bascule vers un autre dossier comptable. Toutes les requêtes suivantes utiliseront ce dossier par défaut. Vérifie la connexion avec l'endpoint /me après le switch.
Inputs: slug (required). Returns: result
pennylane_unletter_linesAIdempotent
Supprime le lettrage de lignes d'écriture. Utile pour corriger un rapprochement erroné.
Inputs: line_ids (required), strategy. Returns: result
pennylane_update_accountAIdempotent
Modifie le libellé ou le statut lettrable d'un compte existant.
Inputs: id (required), label, letterable. Returns: result
pennylane_update_billing_subscriptionAIdempotent
Modifie un abonnement de facturation existant. Seuls les champs fournis sont mis à jour.
Inputs: id (required), label, start, payment_method, +2 more. Returns: result
pennylane_update_categoryBIdempotent
Modifie une catégorie analytique existante. Seuls les champs fournis sont mis à jour.
Inputs: id (required), label, direction, analytical_code. Returns: result
pennylane_update_company_customerAIdempotent
Modifie un client entreprise existant. Seuls les champs fournis sont mis à jour.
Inputs: id (required), name, notes, phone, +4 more. Returns: result
pennylane_update_customer_invoiceAIdempotent
Modifie une facture client (brouillon uniquement). Seuls les champs fournis sont mis à jour.
Inputs: id (required), date, deadline, customer_id, +2 more. Returns: result
pennylane_update_entryAIdempotent
Modifie une écriture existante. Permet de changer l'en-tête et de créer/modifier/supprimer des lignes. L'écriture doit rester équilibrée.
Inputs: id (required), date, label, currency, +5 more. Returns: result
pennylane_update_individual_customerAIdempotent
Modifie un client particulier existant. Seuls les champs fournis sont mis à jour.
Inputs: id (required), notes, phone, emails, +3 more. Returns: result
pennylane_update_productAIdempotent
Modifie un produit existant. Seuls les champs fournis sont mis à jour.
Inputs: id (required), unit, label, vat_rate, +4 more. Returns: result
pennylane_update_quoteBIdempotent
Modifie un devis existant. Seuls les champs fournis sont mis à jour.
Inputs: id (required), date, currency, deadline, +4 more. Returns: result
pennylane_update_quote_statusBIdempotent
Met à jour le statut d'un devis (accepté, refusé, facturé, etc.).
Inputs: id (required), status (required). Returns: result
pennylane_update_supplierBIdempotent
Modifie un fournisseur existant. Seuls les champs fournis sont mis à jour.
Inputs: id (required), iban, name, emails, +4 more. Returns: result
pennylane_update_supplier_invoiceAIdempotent
Modifie une facture fournisseur. Seuls les champs fournis sont mis à jour.
Inputs: id (required), date, deadline, supplier_id, +1 more. Returns: result
pennylane_update_supplier_invoice_payment_statusCIdempotent
Met à jour le statut de paiement d'une facture fournisseur.
Inputs: payment_status (required), supplier_invoice_id (required). Returns: result
pennylane_whoamiARead-onlyIdempotent
Vérifie la connexion à l'API Pennylane et retourne les infos de l'utilisateur et de la société connectée. Utilisez cet outil en premier pour valider que le token est fonctionnel.
Returns: str: JSON avec les informations du compte connecté.
Inputs: no named parameters. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 87 tools
Many tools target distinct resources and actions, but several line/section/category tools overlap in purpose (e.g. list_entry_lines vs list_all_entry_lines, list_categories vs list_group_categories vs list_category_groups). The undescribed changelog_* tools add further ambiguity, though most descriptions do help clarify boundaries.
All tools use the pennylane_ prefix and snake_case, and most follow a predictable verb_noun pattern. A few names break the pattern (changelog_customers, current_dossier, multi_dossier_query), but the overall convention is clear.
87 tools is an extreme mismatch for a single MCP server and far exceeds the 50+ threshold for a severe over-scoping. Even accounting for the broad domain, many CRUD variants could be consolidated or omitted.
The surface covers many accounting resources, including accounts, journals, entries, invoices, quotes, subscriptions, exports, and dossier management. However, delete operations are missing for most resources, journals lack update, and supplier invoices lack a create tool, creating notable lifecycle gaps.
Maintenance
Related MCP Connectors
Pennylane MCP server for ChatGPT, Claude and any AI agent: create customer invoice, send invoice, upload supplier invoice, categorise transaction and list unpaid invoices in your own Pennylane account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Pennylane yourself; Cotlet does not store your password and you need no Pennylane API key. About the official Pennylane API: Yes, Pennylane has a public REST API (Company API v2) with read and write scopes for customers, customer and supplier invoices, transactions, categories and ledger entries (checked 14 Oct 2026). It needs the Essentiel plan or higher and an API token, and the official Pennylane MCP server is read-only for now: it cannot create or send an invoice. Setup and FAQ: https://cotlet.dev/integrations/pennylane-api-mcp-server
Connect Claude to Dutch accounting software: e-Boekhouden invoices, contacts and ledgers.
QuickBooks Online in Claude and ChatGPT: 221 tools, full ledger, multi-company, Canada + US, FR/EN.
Create contacts, move deals, send proposals and invoices, read your inbox, from Claude or ChatGPT.
Related MCP Servers
- AlicenseNot gradedqualityAmaintenanceComplete Swiss accounting integration for Bexio via MCP. Works with Claude Desktop, n8n, and any MCP client. 221 tools for invoices, contacts, projects & more. Created by Lukas Hertig.41MIT
- FlicenseNot gradedqualityDmaintenanceConnects Claude Desktop to the MonKey Office Connect JSON-API, enabling natural language queries for accounting data like bookings, invoices, and open items. It allows users to retrieve information about companies, accounts, customers, and projects through a set of specialized tools.-
- AlicenseBqualityDmaintenanceEnables AI assistants to interact with the BuchhaltungsButler accounting API via MCP, providing tools for managing receipts, transactions, invoices, postings, and master data directly from Claude Desktop and other MCP-compatible clients.2323 npmMIT
- AlicenseAqualityBmaintenanceConnects Claude Desktop, Claude Code, and other MCP-compatible clients to cloud accounting and GST billing records, enabling GST-compliant invoice creation, ledger and voucher management, balance queries, and real-time financial reporting through natural language with role-based tenant isolation.2238 npmMIT