PocketSmith Read-only

officiel

En lecture seule : transactions, budgets, prévisions et analyses de l’outil de finances personnelles PocketSmith.

Que pouvez-vous faire avec PocketSmith Read Only MCP ?

  • Bilan de santé financière — Demandez un aperçu de votre patrimoine net, de votre rythme de dépenses par rapport au budget et de l’état du budget par catégorie.
  • Comparaisons des dépenses — Comparez les dépenses entre deux périodes par catégorie et par bénéficiaire pour voir ce qui a changé.
  • Détection des dépenses récurrentes — Repérez les abonnements et les factures récurrentes, avec leur fréquence et leur coût annuel total.
  • Prévisions de trésorerie et de patrimoine net — Projetez les soldes des comptes et le patrimoine net à l’aide du moteur de prévision de PocketSmith.
  • Recherche de transactions — Recherchez des transactions en les filtrant par date, catégorie, mot-clé ou statut.
  • Liens directs — Obtenez un lien vers la page, le rapport ou la recherche filtrée PocketSmith exacte dont il est question.

Serveur MCP hébergé

npx add-mcp 'https://mcp-readonly.pocketsmith.com/mcp'

S’installe dans Claude Code, Codex, Cursor et plus

Documentation

Serveur MCP

Connectez votre compte PocketSmith à tout assistant IA compatible avec le Model Context Protocol.

En connectant votre assistant IA à PocketSmith via le Model Context Protocol (MCP), vous lui donnez un accès direct à vos données financières, à vos budgets et à vos prévisions. Il peut vous fournir des analyses et des informations, ainsi qu’effectuer diverses actions pour vous.

Fonctionnalités

Le serveur MCP de PocketSmith permet aux assistants IA de consulter et de gérer vos données PocketSmith en votre nom. Au lieu de passer de votre assistant IA à PocketSmith, vous pouvez poser des questions et effectuer des actions en langage naturel :

  • Examiner vos dépenses, vos budgets et votre valeur nette
  • Rechercher et catégoriser des transactions
  • Créer et mettre à jour des événements budgétaires
  • Analyser les tendances et comparer les dépenses sur différentes périodes
  • Vérifier l’état de synchronisation des flux bancaires et lancer leur actualisation
  • Obtenir des liens directs vers la bonne page ou le bon rapport PocketSmith

Deux modes d’accès sont disponibles :

ModeDescriptionMéthode de connexion
Accès completLes 66 outils : consulter, créer, mettre à jour et supprimerEn un clic depuis le répertoire Claude ou ChatGPT
Lecture seule40 outils en lecture seule : consulter et analyser, sans modificationConfiguration manuelle comme connecteur personnalisé (quelques étapes supplémentaires)

La plupart des utilisateurs devraient choisir l’accès complet. Toute suppression nécessite toujours votre approbation explicite, et vous pouvez demander à l’assistant de vous consulter avant d’effectuer toute autre modification. Choisissez la lecture seule si vous voulez avoir la garantie que l’assistant ne pourra jamais modifier vos données.

Connexion

L’accès complet est proposé comme application répertoriée dans les répertoires Claude et ChatGPT : la connexion se fait donc en un seul clic. La lecture seule n’est pas encore répertoriée dans ces répertoires ; elle doit être ajoutée manuellement comme connecteur personnalisé à l’aide de l’URL indiquée dans la section Autres clients MCP ci-dessous.


Claude (claude.ai, Claude Desktop et applications mobiles)

Accès complet :

  1. Ouvrez PocketSmith Complete Access dans le répertoire Claude
  2. Cliquez sur Connect
  3. Vous serez redirigé vers PocketSmith pour autoriser l’accès

Les connecteurs sont associés à votre compte Claude. Une fois PocketSmith connecté sur claude.ai, il est également disponible dans Claude Desktop et les applications mobiles Claude.

Lecture seule :

  1. Sur claude.ai ou dans Claude Desktop, ouvrez Settings > Connectors
  2. Cliquez sur Add custom connector
  3. Saisissez un nom (par exemple, « PocketSmith Read-only ») et l’URL https://mcp-readonly.pocketsmith.com/mcp
  4. Cliquez sur Connect à côté du nouveau connecteur et autorisez l’accès dans PocketSmith

Claude Code

# Full access
claude mcp add pocketsmith --transport http https://mcp.pocketsmith.com/mcp

# Read-only
claude mcp add pocketsmith-readonly --transport http https://mcp-readonly.pocketsmith.com/mcp

Claude Code vous invitera à vous authentifier via OAuth lors de la première utilisation.

ChatGPT (chatgpt.com et application de bureau)

Accès complet :

  1. Ouvrez PocketSmith dans le répertoire des applications ChatGPT sur chatgpt.com
  2. Cliquez sur Connect
  3. Vous serez redirigé vers PocketSmith pour autoriser l’accès

Les applications sont associées à votre compte ChatGPT. Une fois PocketSmith connecté sur chatgpt.com, il est également disponible dans l’application de bureau ChatGPT. S’il n’apparaît pas, redémarrez l’application de bureau.

Lecture seule :

La lecture seule doit être configurée sur chatgpt.com, et non dans l’application de bureau :

  1. Ouvrez Settings > Apps & Connectors et activez Developer mode (dans les paramètres avancés)
  2. Cliquez sur Create pour ajouter un connecteur personnalisé
  3. Saisissez un nom (par exemple, « PocketSmith Read-only ») et l’URL https://mcp-readonly.pocketsmith.com/mcp
  4. Cliquez sur Connect : vous serez redirigé vers PocketSmith pour autoriser l’accès

N’utilisez pas l’option Settings > Plugins > Add MCP server de l’application de bureau : les serveurs ajoutés de cette manière sont uniquement disponibles dans Codex, pas dans ChatGPT.

Espaces de travail Business/Enterprise/Edu : un administrateur de l’espace de travail doit d’abord activer l’application ou ajouter le connecteur depuis Workspace settings. Chaque utilisateur se connecte ensuite et autorise individuellement son propre compte PocketSmith.

Codex

Accès complet : si vous avez déjà connecté PocketSmith depuis le répertoire des applications ChatGPT, il sera automatiquement disponible dans Codex dès votre prochaine conversation. Sinon, ajoutez-le depuis la ligne de commande :

codex mcp add pocketsmith --transport http https://mcp.pocketsmith.com/mcp

Lecture seule :

codex mcp add pocketsmith-readonly --transport http https://mcp-readonly.pocketsmith.com/mcp

Codex vous invitera à vous authentifier via OAuth lors de la première utilisation.

Autres clients MCP

ModeURL
Accès complethttps://mcp.pocketsmith.com/mcp
Lecture seulehttps://mcp-readonly.pocketsmith.com/mcp

Tout client MCP compatible avec le transport HTTP et OAuth peut se connecter à l’aide de ces URL. Le serveur prend en charge OAuth 2.0 avec PKCE et publie ses métadonnées de découverte à /.well-known/oauth-authorization-server et /.well-known/oauth-protected-resource.

Authentification

L’authentification est gérée automatiquement via OAuth. Lors de votre première connexion, vous serez redirigé vers PocketSmith pour vous connecter et autoriser l’accès. L’assistant IA reçoit un jeton limité au mode d’accès choisi (complet ou lecture seule) et ne voit jamais votre mot de passe PocketSmith.

Les jetons sont chiffrés et sans état : rien n’est stocké sur le serveur MCP. Vous pouvez révoquer l’accès à tout moment depuis la page Applications autorisées PocketSmith.

Exemples d’utilisation

« Comment se passent mes finances ce mois-ci ? »

Demandez un bilan de santé financière pour obtenir un aperçu rapide :

Vous : Comment vont mes finances ce mois-ci ? Est-ce que je respecte mon budget ?

Utilise l’outil financial_health_snapshot pour présenter votre valeur nette, le rythme de vos dépenses du mois en cours par rapport au budget, des indicateurs de suivi budgétaire pour chaque catégorie et les actions à entreprendre, comme catégoriser les transactions non catégorisées.


« Quels abonnements est-ce que je paie ? »

Repérez les prélèvements récurrents que vous avez peut-être oubliés :

Vous : Peux-tu trouver toutes mes dépenses récurrentes et mes abonnements ? Je veux voir combien je paie chaque mois et le coût annuel total.

Utilise l’outil find_recurring_expenses pour analyser l’historique de vos transactions, repérer les prélèvements réguliers par bénéficiaire, déterminer leur fréquence et calculer leur coût annuel total.


« Compare mes dépenses à celles du mois dernier »

Découvrez comment la répartition de vos dépenses a changé :

Vous : Compare mes dépenses de ce mois-ci à celles du mois dernier. Quelles catégories ont augmenté ou diminué ?

Utilise l’outil spending_comparison pour détailler les deux périodes par catégorie et par bénéficiaire, en mettant en évidence les changements ainsi que les bénéficiaires apparus ou disparus.


« Fais le bilan de mes finances de mars »

Obtenez un bilan complet de fin de mois :

Vous : Fais un bilan complet de mars 2025 : revenus, dépenses, taux d’épargne et respect de mon budget.

Utilise l’outil month_end_review pour produire un rapport détaillé comprenant un récapitulatif des revenus et des dépenses, le taux d’épargne, les écarts budgétaires par catégorie, les principaux bénéficiaires, les transactions notables et un aperçu de la valeur nette.


« Catégorise mes transactions récentes »

Mettez de l’ordre dans les transactions non catégorisées :

Vous : J’ai plusieurs transactions non catégorisées de la semaine dernière. Peux-tu les examiner et les catégoriser pour moi ?

Utilise list_transactions pour trouver les transactions récentes non catégorisées, puis list_categories pour consulter l’arborescence de vos catégories, et update_transaction pour attribuer les catégories appropriées en fonction des noms des bénéficiaires. (Nécessite le mode d’accès complet.)


« Quel sera le solde de mon compte d’épargne dans 6 mois ? »

Projetez l’évolution du solde de vos comptes :

Vous : À quoi ressemblera le solde de mon compte d’épargne au cours des 6 prochains mois, d’après mon budget ?

Utilise cash_flow_forecast pour projeter les soldes à l’aide du moteur de prévision de PocketSmith, montrer l’évolution prévue de chaque compte et signaler les moments où les soldes pourraient passer sous un seuil de sécurité.


« Emmène-moi à la bonne page »

Obtenez un lien direct vers la bonne page ou le bon rapport dans l’application Web PocketSmith :

Vous : Comment mes dépenses d’épicerie ont-elles évolué au cours de l’année écoulée ? Donne-moi un lien pour que je puisse examiner ça moi-même.

Utilise get_trend_analysis pour résumer la tendance, puis navigate_to_trends pour créer un lien direct vers le rapport Tendances, préfiltré selon votre catégorie Épicerie et la période choisie, afin que vous puissiez poursuivre votre exploration dans PocketSmith. Tous les outils de navigation fonctionnent ainsi : l’assistant répond, puis vous fournit un lien vers la page, le rapport ou la recherche de transactions exacte dont il parlait.

Outils disponibles

Analyses (outils d’analyse combinée)

Ces outils combinent plusieurs appels d’API pour produire des analyses détaillées, prêtes à l’emploi :

OutilFonctionnalité
financial_health_snapshotValeur nette, rythme des dépenses, indicateurs de suivi budgétaire, actions à entreprendre
month_end_reviewBilan complet d’une période : revenus et dépenses, taux d’épargne, écarts budgétaires, principaux bénéficiaires
spending_comparisonComparaison côte à côte de deux périodes par catégorie et par bénéficiaire
find_recurring_expensesDétection des abonnements et factures récurrentes, avec calcul du coût annuel
cash_flow_forecastProjections des soldes des comptes et alertes en cas de risque
net_worth_forecastÉvolution de la valeur nette : tendances historiques, prévisions et projections de jalons
forecast_accuracyComparaison des soldes réels et prévisionnels pour évaluer la fiabilité du budget

Budgétisation

OutilFonctionnalité
get_budgetAnalyse budgétaire par catégorie pour la période prévisionnelle
get_budget_summaryComparaison des dépenses et revenus réels au budget pour une période donnée
get_trend_analysisTendances des dépenses par catégorie au fil du temps
delete_forecast_cacheForcer le recalcul du budget après des modifications groupées

Transactions

OutilFonctionnalité
list_transactionsRechercher et filtrer les transactions par date, catégorie, mot-clé et statut
get_transactionObtenir tous les détails d’une transaction
create_transactionAjouter une transaction
update_transactionModifier une transaction (bénéficiaire, catégorie, libellés, notes, répartitions)
delete_transactionSupprimer une transaction

Comptes et établissements

OutilFonctionnalité
list_accountsRépertorier tous les comptes par utilisateur ou établissement
get_accountObtenir les détails d’un compte, notamment son solde et ses comptes enfants
create_account / update_account / delete_accountGérer les comptes
update_account_display_orderRéorganiser les comptes
list_institutions / get_institutionConsulter les établissements financiers
create_institution / update_institution / delete_institutionGérer les établissements
list_transaction_accounts / get_transaction_account / update_transaction_accountConsulter et mettre à jour les comptes de transaction

Catégories et règles

OutilFonctionnalité
list_categories / get_categoryAfficher votre hiérarchie de catégories
create_category / update_category / delete_categoryGérer les catégories
list_category_rules / create_category_ruleAfficher et créer des règles de catégorisation automatique

Événements budgétaires

OutilFonctionnalité
list_events / get_eventAfficher les événements prévisionnels du budget
create_event / update_event / delete_eventGérer les événements budgétaires récurrents et ponctuels

Pièces jointes

OutilFonctionnalité
list_attachments / get_attachmentAfficher les reçus et les pièces jointes des documents
create_attachment / update_attachment / delete_attachmentGérer les pièces jointes
assign_transaction_attachment / unassign_transaction_attachmentAssocier/dissocier des pièces jointes à des transactions

Flux de données

OutilFonctionnalité
get_data_feeds_connection_statusVérifier l’état de synchronisation du flux bancaire et les détails du fournisseur
refresh_data_feeds_connectionLancer une synchronisation pour une ou toutes les connexions de flux bancaires

Navigation

Ces outils génèrent des liens profonds afin que l’assistant puisse vous diriger vers la page PocketSmith exacte correspondant à la conversation, avec des filtres prédéfinis pour les comptes, les catégories et les dates appropriés, ainsi que tout autre contrôle de page nécessaire au rapport.

OutilFonctionnalité
navigate_to_transactionsRecherche de transactions, avec filtres prédéfinis par compte, catégorie, mot-clé ou date
navigate_to_budgetAccéder à la page du budget, avec les paramètres de date et d’autres options contrôlables via le lien
navigate_to_trendsRapport de tendances des dépenses ou revenus d’une catégorie au fil du temps, avec toutes les options disponibles via le lien
navigate_to_income_expenseRapport des revenus et dépenses (compte de résultat), avec filtres, plages de dates et autres options disponibles via le lien
navigate_to_cashflowsÉtat des flux de trésorerie (tableau mensuel)
navigate_to_net_worthPage de la valeur nette, avec tous les filtres et autres options disponibles via le lien
navigate_to_calendarCalendrier des événements budgétaires et soldes planifiés et prévisionnels, avec plages de dates disponibles via le lien
navigate_to_account_summaryRécapitulatif du compte pour un compte et un mois spécifiques

Autres

OutilFonctionnalité
get_current_user / update_userAfficher et mettre à jour le profil et les paramètres utilisateur
list_labelsAfficher toutes les étiquettes de transaction
list_saved_searchesAfficher les filtres de recherche de transactions enregistrés
list_currencies / get_currencyDonnées de référence sur les devises
list_time_zonesDonnées de référence sur les fuseaux horaires

Modèle de données PocketSmith

Comprendre la hiérarchie de PocketSmith aide à formuler vos questions :

Institution (e.g. "Sample Bank")
  → Account (container/group, e.g. "Everyday Credit Card")
      → Transaction Account (where transactions live)
      → Scenario (where budget forecast events live)
  • Institutions : banques ou prestataires financiers
  • Comptes : regroupent un ou plusieurs comptes de transaction et scénarios
  • Comptes de transaction : contiennent les enregistrements de transactions proprement dits
  • Scénarios : contiennent les événements budgétaires qui alimentent le moteur de prévision de PocketSmith
  • Catégories : organisées de manière hiérarchique (parent/enfant) et partagées entre tous les comptes
  • Étiquettes : balises que vous pouvez ajouter aux transactions pour les regrouper de manière flexible

Confidentialité et sécurité

  • Politique de confidentialité de PocketSmith : https://www.pocketsmith.com/legal/privacy-policy/
  • Vos identifiants PocketSmith ne sont jamais communiqués à l’assistant IA
  • Les jetons OAuth sont chiffrés avec AES-256-GCM et sont sans état (aucune donnée n’est stockée côté serveur)
  • Toutes les communications API utilisent le chiffrement TLS
  • Vous pouvez révoquer l’accès à tout moment depuis les applications autorisées PocketSmith

Assistance