MCP Finary - Implémentation maison

Hello tout le monde :waving_hand:,

Je me permets de faire un petit post pour partager le MCP Maison que j’ai fait sur Finary.

J’utilise beaucoup Finary pour centraliser mes dépenses, mes investissements et le suivi partagé avec ma femme.

Le problème : je veux une vue propre de mes finances, mais je n’ai aucune envie de passer du temps à catégoriser et renommer chaque transaction à la main.

J’ai donc développé un petit serveur MCP personnel :

Il permet Ă  mon agent de :

  • lister les transactions non traitĂ©es ;
  • proposer un nom et une catĂ©gorie en s’appuyant sur mes habitudes passĂ©es ;
  • me prĂ©senter une synthèse courte pour validation ;
  • appliquer ensuite les renommages / catĂ©gories validĂ©s ;
  • rĂ©pondre Ă  des questions simples sur mes dĂ©penses ou abonnements.

Je garde la validation finale, mais je ne fais plus le travail répétitif dans l’interface.

Le point bloquant : l’authentification

Finary ne propose pas, à ma connaissance, d’API publique ni de flux OAuth pour ce type d’intégration.

Pour mon usage personnel, j’ai donc reverse-engineeré les appels utilisés par l’application web. Le serveur utilise mon cookie / token de session Finary côté backend, protégé par une clé API sur l’instance MCP.

Ce n’est clairement pas une solution idéale :

  • le token peut expirer ;
  • il faut le renouveler manuellement ;
  • je ne conseillerais pas de donner son cookie Finary Ă  une instance hĂ©bergĂ©e par quelqu’un d’autre.

Si jamais vous voulez tester

Vous pouvez faire tourner le serveur vous-même et renseigner votre propre token de session dans votre environnement. Comme ça, vos identifiants restent chez vous.

La doc d’installation est dans le repo :

Je pense qu’il y aurait beaucoup de valeur pour devenir l’outil indispensable pour le tracking des finances personnelles ! ChatGPT s’est déjà lancé là dessus aux US, Finary pourrait être une bonne version européenne !

Tu l’as probablement vu mais il y a une beta d’un serveur MCP officiel : [Beta] Le MCP Finary est disponible, construisons-le ensemble

Malheureusement, pas de budget et pas d’écriture pour le moment.

@Quentin339 to maintain the connection you can take inspiration from what I did with nmathey/finahack and the work of lasconic/finary_uapi: Finary uses the Clerk module and it’s possible for a script to retrieve its own connection cookie which will be regenerated on demand when necessary.

I had started working on an MCP by the way (nmathey/finary_uapi at MCP-server) but the official Finary one came out a few months later which is sufficient for me today.

However, I would like to be able to write bank transactions via the API/MCP, something that’s not possible even on the web interface: the day this becomes possible it would be great because not all my banks are « connectable Â»â€¦ [Feature] Manual addition of transactions on bank account