Qu’est-ce que WhatsApp MCP (finereli) ?
WhatsApp MCP, d'Eli Finer (finereli sur GitHub), se connecte à votre compte WhatsApp comme appareil associé, à la manière de WhatsApp Web, importe l'historique que WhatsApp transmet à un nouvel appareil et permet à un client MCP de lister les discussions, de les lire, de chercher dans toutes, de trouver celles restées sans réponse et de récupérer photos, notes vocales et documents. Il ne peut rien envoyer, modifier ni supprimer ; aucun outil ne le permet.
Il fonctionne comme Cloudflare Worker avec un Durable Object par personne, ou sur votre propre machine sous Docker. Vous pouvez utiliser la bêta hébergée gratuite sur whatsapp.finereli.com, qui vous connecte avec Google et a un nombre de places limité, ou déployer votre propre copie avec un mot de passe que vous seul connaissez. Le dépôt est en TypeScript sous licence MIT, créé le 18 octobre 2026, avec environ 415 étoiles et des commits jusqu'au 10 novembre 2026. Il parle à WhatsApp via la bibliothèque non officielle Baileys, figée sur une release candidate.
Installer WhatsApp MCP (finereli)
https://whatsapp.finereli.com/mcpWhatsApp MCP (finereli) vaut-il le coup ?
Ce sont les choix de conception qui justifient cette critique. Il n'y a pas d'outil d'envoi, à dessein, ce qui écarte le pire raté d'un agent de messagerie. Les messages, les noms de discussions et de contacts et les clés de session de WhatsApp elles-mêmes sont chiffrés au repos sous une clé de données aléatoire, elle-même enveloppée par une clé tirée de votre mot de passe (PBKDF2-SHA256, 600,000 itérations) ou du service de connexion hébergé. Les numéros de téléphone sont stockés sous forme de hachages à clé, et la recherche passe par des filtres par bloc d'environ 128 messages, si bien qu'une base copiée montre les rythmes d'activité et la longueur des messages, mais ni qui ni quoi.
Le README est d'une rare clarté sur l'endroit où cette protection s'arrête, et le lecteur doit l'être aussi. Ce n'est pas du chiffrement de bout en bout : pendant que votre agent interroge, le serveur détient la clé et lit vos messages en clair, et ce que l'agent lit part chez son fournisseur de modèles. Sur la bêta hébergée, l'opérateur gère le service de connexion et pourrait dériver votre clé ; seule une copie auto-hébergée avec OWNER_PASSWORD supprime ce point. Il n'y a aucune étape de confirmation avant qu'un agent lise une discussion, et toutes les personnes de ces discussions figurent dans la copie sans l'avoir accepté.
Le risque pour le compte est réel, quoique faible. Il utilise le protocole de WhatsApp Web via Baileys, ce que les conditions de WhatsApp déconseillent, et l'auteur prévient que WhatsApp pourrait restreindre ou fermer un compte qui le fait. Les comptes hébergés se connectent depuis des adresses de centres de données Cloudflare, ce qui peut attirer davantage l'attention qu'un téléphone. La synchronisation n'a lieu que lorsqu'un agent le demande, car rien ne peut déchiffrer sans que vous soyez connecté ; WhatsApp ne garde les messages destinés à un appareil associé que pour une durée limitée, donc une longue pause peut imposer une nouvelle association.
Le rival est lharries/whatsapp-mcp, avec environ 6,870 étoiles le serveur le plus connu, mais il peut envoyer des messages et n'a reçu aucun commit depuis juillet 2025. Celui-ci a moins d'un mois, n'a été testé que sur un seul vrai compte de l'aveu de son auteur, et les modifications et suppressions restent non testées. L'auto-hébergement sur Cloudflare coûte $5 par mois et quelques minutes avec wrangler, et c'est la version à laquelle nous confierions un historique personnel.
Là où il fait la différence
Une mère qui jongle entre les groupes de l'école, du sport et de la famille
Rattraper ce que le groupe familial a décidé cette semaine
Demandez à l'agent un résumé du groupe depuis lundi ; il met la copie à jour depuis WhatsApp si elle date de plus de dix minutes, puis lit la discussion. Gratuit sur la bêta hébergée ; $5 par mois en auto-hébergement.
Un graphiste indépendant qui négocie ses missions avec ses clients sur WhatsApp
Retrouver ce qu'un client a dit du brief et de l'échéance
search_messages accepte plusieurs requêtes en mots exacts à la fois sur toutes les discussions, et get_media récupère le PDF joint. La recherche porte sur des mots entiers, sans approximation : demandez 'deadline' et 'invoice*' plutôt qu'une paraphrase.
Un artisan qui répond à ses clients depuis un numéro personnel
Voir quels clients attendent encore une réponse
unanswered_chats liste les discussions directes où l'autre personne a écrit en dernier. L'agent rédige des réponses que vous envoyez depuis le téléphone, puisque le serveur lui-même ne peut pas envoyer.
Avant de vous engager
- Mise en route
- Hébergé : connectez-vous avec Google sur whatsapp.finereli.com, scannez le code QR dans Appareils connectés de WhatsApp et ajoutez https://whatsapp.finereli.com/mcp. Auto-hébergé : clonez, npm install, créez un espace de noms KV, définissez OWNER_PASSWORD (12+ caractères) et npm run deploy, ou docker compose up derrière un proxy TLS.
- Intégrations
- 11 outils : list_chats, get_messages, search_messages, unanswered_chats, get_media, transcribe_audio, unnamed_chats, set_contact_names, sync_now, link_status et relink. Fonctionne avec Claude, ChatGPT, Grok et d'autres clients MCP distants via OAuth.
- Données et confidentialité
- Messages stockés dans SQLite au sein d'un Durable Object Cloudflare, chiffrés en AES-256-GCM au repos ; horodatages, types de message et longueurs approximatives restent lisibles. Déchiffrés en mémoire pendant les requêtes. Les médias sont récupérés à la demande, non stockés. La suppression depuis le tableau de bord efface tout.
- Coût à grande échelle
- Auto-hébergé pour une personne : le forfait Workers Paid à $5/mois. En service partagé, le README estime environ $10 par mois au pire pour 100 personnes avec les plafonds par défaut, plus probablement $5 à $7.
- Limites
- Comptes hébergés plafonnés par défaut à 250,000 messages et 300 Mo ; n'importe que ce que WhatsApp envoie à un nouvel appareil, une fois par association ; recherche en mots exacts ; certaines discussions apparaissent comme de simples numéros tant qu'elles n'ont pas de nom.
Les points forts
- Lecture seule : aucun outil pour envoyer, modifier ou supprimer
- Chiffré au repos ; numéros stockés en hachages à clé
- Auto-hébergeable sur Cloudflare ou Docker avec votre mot de passe
- Tout supprimer et dissocier depuis le tableau de bord
Les points faibles
- Protocole non officiel ; WhatsApp pourrait restreindre le compte
- L'opérateur de la bêta hébergée peut dériver votre clé
- Texte en clair en mémoire à chaque requête
- Moins d'un mois d'existence ; testé sur un seul vrai compte
Idéal pour
Les personnes qui veulent qu'un agent retrouve des choses dans leur historique WhatsApp personnel et sont prêtes à l'auto-héberger pour la confidentialité que cela suppose.
Alternatives à WhatsApp MCP (finereli)
WhatsApp MCP (finereli) : questions fréquentes
- WhatsApp MCP (finereli) vaut-il le coup ?
- Une façon mûrement réfléchie, en lecture seule, de laisser un agent chercher dans votre WhatsApp, à condition de faire tourner votre propre copie et d'accepter le risque pour le compte qu'impliquent les conditions de WhatsApp. Nous lui donnons 3.8 sur 5.
- Combien coûte WhatsApp MCP (finereli) ?
- Gratuit et open source (MIT). Bêta hébergée gratuite avec places limitées. L'auto-hébergement sur Cloudflare exige le forfait Workers Paid à $5/mois ; transcrire les notes vocales coûte environ $0.0005 la minute sur Workers AI.
- Quels sont les inconvénients de WhatsApp MCP (finereli) ?
- Protocole non officiel ; WhatsApp pourrait restreindre le compte; l'opérateur de la bêta hébergée peut dériver votre clé; texte en clair en mémoire à chaque requête; moins d'un mois d'existence ; testé sur un seul vrai compte.
- À qui s’adresse WhatsApp MCP (finereli) ?
- Les personnes qui veulent qu'un agent retrouve des choses dans leur historique WhatsApp personnel et sont prêtes à l'auto-héberger pour la confidentialité que cela suppose.
- Combien coûte WhatsApp MCP (finereli) pour une équipe ou en production ?
- Auto-hébergé pour une personne : le forfait Workers Paid à $5/mois. En service partagé, le README estime environ $10 par mois au pire pour 100 personnes avec les plafonds par défaut, plus probablement $5 à $7.
- WhatsApp MCP (finereli) est-il sûr pour les données de l’entreprise ?
- Messages stockés dans SQLite au sein d'un Durable Object Cloudflare, chiffrés en AES-256-GCM au repos ; horodatages, types de message et longueurs approximatives restent lisibles. Déchiffrés en mémoire pendant les requêtes. Les médias sont récupérés à la demande, non stockés. La suppression depuis le tableau de bord efface tout.
- Quelles sont les meilleures alternatives à WhatsApp MCP (finereli) ?
- Les alternatives les plus proches que nous avons testées sont Slack MCP Server et Google Workspace MCP servers.
Réponses vérifiées le 13 nov. 2026.