Skip to main content
Glama
pennylane-mcp-server

pennylane-mcp-server

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 (src/pennylane_mcp/oauth.py, server.py)

Le serveur se branche sur claude.ai web et mobile, protégé par un mot de passe

Factures lisibles (tools/customer_invoices.py, tools/quotes.py)

« Impayées », « en retard avant le 15 », « émises en septembre » s'obtiennent en un appel. Le filtre status, que l'API refuse, est appliqué par le serveur. Les listes sont compactes, et la fiche facture contient ses lignes, ses paiements et ses rapprochements bancaires

Déploiement (Dockerfile, compose.yaml, deploy/Caddyfile)

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és

En 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

  1. Ouvrez un terminal. Sur macOS : ⌘ + Espace, tapez « Terminal », Entrée. Sur Windows : menu Démarrer, « PowerShell ».

  2. Installez uv, qui télécharge et lance le serveur pour vous.

    • macOS ou Linux : curl -LsSf https://astral.sh/uv/install.sh | sh

    • Windows : powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

  3. Fermez le terminal et ouvrez-en un nouveau, sinon la commande uvx reste 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')"

    ok doit 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.

  4. Trouvez le chemin complet de uvx : which uvx sur macOS (souvent /Users/VOTRENOM/.local/bin/uvx), where uvx sur Windows. Claude Desktop ne connaît pas votre PATH, d'où le chemin complet.

  5. 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" }
        }
      }
    }
  6. 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-server

Voie 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 --build

Puis, 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.

  1. URL : https://votre-domaine/mcp

  2. Dans 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.

  3. Une page « pennylane-mcp » s'ouvre : saisissez la valeur de MCP_BEARER_TOKEN (ou de MCP_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 32 et 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.

  • .env et dossiers.json sont 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_quote et les outils d'écriture renvoient encore public_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 (voir docs/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 jeton

Licence

MIT. La licence d'origine de Melvyn Morice est conservée dans LICENSE.

Available Tools

87 tools
pennylane_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_invoicesD
Read-onlyIdempotent

Inputs: sort, limit, cursor. Returns: result

pennylane_changelog_customersD
Read-onlyIdempotent

Inputs: sort, limit, cursor. Returns: result

pennylane_changelog_entry_linesD
Read-onlyIdempotent

Inputs: sort, limit, cursor. Returns: result

pennylane_changelog_productsD
Read-onlyIdempotent

Inputs: sort, limit, cursor. Returns: result

pennylane_changelog_quotesD
Read-onlyIdempotent

Inputs: sort, limit, cursor. Returns: result

pennylane_changelog_supplier_invoicesD
Read-onlyIdempotent

Inputs: sort, limit, cursor. Returns: result

pennylane_changelog_suppliersD
Read-onlyIdempotent

Inputs: sort, limit, cursor. Returns: result

pennylane_changelog_transactionsD
Read-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_dossierA
Read-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_accountA
Read-onlyIdempotent

Récupère le détail d'un compte comptable par son identifiant.

Inputs: id (required). Returns: result

pennylane_get_agl_exportA
Read-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_subscriptionB
Read-onlyIdempotent

Récupère le détail complet d'un abonnement de facturation.

Inputs: id (required). Returns: result

pennylane_get_categoryB
Read-onlyIdempotent

Récupère le détail d'une catégorie analytique par son identifiant.

Inputs: id (required). Returns: result

pennylane_get_category_groupB
Read-onlyIdempotent

Récupère le détail d'un groupe de catégories par son identifiant.

Inputs: id (required). Returns: result

pennylane_get_customerA
Read-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_invoiceA
Read-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_entryB
Read-onlyIdempotent

Récupère le détail complet d'une écriture comptable avec toutes ses lignes.

Inputs: id (required). Returns: result

pennylane_get_entry_lineB
Read-onlyIdempotent

Récupère le détail d'une ligne d'écriture comptable.

Inputs: id (required). Returns: result

pennylane_get_fec_exportA
Read-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_journalB
Read-onlyIdempotent

Récupère le détail d'un journal comptable par son identifiant.

Inputs: id (required). Returns: result

pennylane_get_productA
Read-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_quoteA
Read-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_supplierA
Read-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_invoiceA
Read-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_balanceA
Read-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_list_accountsA
Read-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_linesA
Read-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_subscriptionsA
Read-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_categoriesA
Read-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_groupsA
Read-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_linesC
Read-onlyIdempotent

Liste les lignes (articles) d'une facture client spécifique.

Inputs: customer_invoice_id (required), limit, cursor. Returns: result

pennylane_list_customer_invoicesA
Read-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_customersA
Read-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_dossiersA
Read-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_entriesB
Read-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_linesC
Read-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_yearsA
Read-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_categoriesB
Read-onlyIdempotent

Liste les catégories appartenant à un groupe spécifique.

Inputs: category_group_id (required), limit, cursor. Returns: result

pennylane_list_journalsB
Read-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_linesA
Read-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_categoriesB
Read-onlyIdempotent

Liste les catégories analytiques associées à une ligne d'écriture.

Inputs: line_id (required), limit, cursor. Returns: result

pennylane_list_productsA
Read-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_linesA
Read-onlyIdempotent

Liste les lignes (articles) d'un devis spécifique.

Inputs: quote_id (required), limit, cursor. Returns: result

pennylane_list_quotesA
Read-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_sectionsC
Read-onlyIdempotent

Liste les sections de lignes d'un devis.

Inputs: quote_id (required), limit, cursor. Returns: result

pennylane_list_subscription_linesC
Read-onlyIdempotent

Liste les lignes de facturation d'un abonnement.

Inputs: subscription_id (required), limit, cursor. Returns: result

pennylane_list_subscription_sectionsC
Read-onlyIdempotent

Liste les sections de lignes d'un abonnement de facturation.

Inputs: subscription_id (required), limit, cursor. Returns: result

pennylane_list_supplier_invoice_linesA
Read-onlyIdempotent

Liste les lignes (articles) d'une facture fournisseur spécifique.

Inputs: supplier_invoice_id (required), limit, cursor. Returns: result

pennylane_list_supplier_invoicesB
Read-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_suppliersA
Read-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_paidA
Idempotent

Marque une facture client finalisée comme payée.

Inputs: id (required). Returns: result

pennylane_multi_dossier_queryA
Read-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_dossierA
Destructive

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_dossierA
Idempotent

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_linesA
Idempotent

Supprime le lettrage de lignes d'écriture. Utile pour corriger un rapprochement erroné.

Inputs: line_ids (required), strategy. Returns: result

pennylane_update_accountA
Idempotent

Modifie le libellé ou le statut lettrable d'un compte existant.

Inputs: id (required), label, letterable. Returns: result

pennylane_update_billing_subscriptionA
Idempotent

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_categoryB
Idempotent

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_customerA
Idempotent

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_invoiceA
Idempotent

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_entryA
Idempotent

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_customerA
Idempotent

Modifie un client particulier existant. Seuls les champs fournis sont mis à jour.

Inputs: id (required), notes, phone, emails, +3 more. Returns: result

pennylane_update_productA
Idempotent

Modifie un produit existant. Seuls les champs fournis sont mis à jour.

Inputs: id (required), unit, label, vat_rate, +4 more. Returns: result

pennylane_update_quoteB
Idempotent

Modifie un devis existant. Seuls les champs fournis sont mis à jour.

Inputs: id (required), date, currency, deadline, +4 more. Returns: result

pennylane_update_quote_statusB
Idempotent

Met à jour le statut d'un devis (accepté, refusé, facturé, etc.).

Inputs: id (required), status (required). Returns: result

pennylane_update_supplierB
Idempotent

Modifie un fournisseur existant. Seuls les champs fournis sont mis à jour.

Inputs: id (required), iban, name, emails, +4 more. Returns: result

pennylane_update_supplier_invoiceA
Idempotent

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_statusC
Idempotent

Met à jour le statut de paiement d'une facture fournisseur.

Inputs: payment_status (required), supplier_invoice_id (required). Returns: result

pennylane_whoamiA
Read-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

    C2.5/5.0

    Scored across 87 tools

    Disambiguation3/5

    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.

    Naming Consistency4/5

    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.

    Tool Count1/5

    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.

    Completeness3/5

    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

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      A
      maintenance
      Complete 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.
      41
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Connects 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.
      -
    • A
      license
      B
      quality
      D
      maintenance
      Enables 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.
      23
      23 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Connects 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.
      22
      38 npm
      MIT