WhatsApp MCP

npx add-mcp 'https://server.wa-mcp.com/mcp'

Documentation WhatsApp MCP

WhatsApp MCP connecte votre assistant IA (Claude, ChatGPT, Cursor ou tout client prenant en charge le Model Context Protocol) au numéro WhatsApp que vous utilisez déjà. Votre assistant peut lire et rechercher vos conversations, identifier qui attend une réponse, et envoyer, programmer, modifier ou réagir aux messages, toujours depuis votre propre numéro et uniquement lorsque vous le demandez.

Il se connecte à WhatsApp en tant qu'appareil lié, de la même manière que WhatsApp Web. Aucune application à installer, aucun nouveau numéro et aucune API Meta Business.

Configuration

Vous vous connectez une fois, puis vous liez votre WhatsApp dans la conversation.

Option A : l'annuaire de connecteurs de Claude

1. Dans Claude, ouvrez l'annuaire de connecteurs et recherchez WhatsApp MCP.
2. Cliquez sur Connecter. Notre page de connexion s'ouvre : vérifiez qu'elle indique bien votre application IA, puis cliquez à nouveau sur Connecter.
3. De retour dans Claude, ouvrez une nouvelle conversation et tapez « Connecte mon WhatsApp » (voir « Lier votre WhatsApp » ci-dessous).

Il n'y a ni inscription ni mot de passe : votre numéro WhatsApp est votre compte, et c'est en le liant que nous savons que c'est bien vous.

Option B : une URL de connexion personnelle (tout client MCP)

1. Rendez-vous sur wa-mcp.com, choisissez votre application IA et cliquez sur Générer mon lien.
2. Ajoutez le lien à votre application IA en tant que connecteur personnalisé (serveur MCP). Le site indique les étapes exactes pour chaque application, et Comment connecter Claude à WhatsApp détaille la procédure pour Claude pas à pas.
3. Ouvrez une nouvelle conversation et tapez « Connecte mon WhatsApp ».

Gardez le lien privé : il fonctionne comme un mot de passe. Vous pouvez utiliser le même lien dans plusieurs applications IA.

Lier votre WhatsApp

Lorsque vous demandez à votre assistant de connecter votre WhatsApp, il vous propose deux méthodes :

• Code QR : votre assistant affiche un code QR (ainsi qu'un lien vers une page le contenant). Sur votre téléphone, ouvrez WhatsApp → Paramètres → Appareils liés → Lier un appareil et scannez-le.
• Code d'appairage : donnez à votre assistant votre numéro de téléphone avec son indicatif pays. Il renvoie un code de 8 caractères. Sur votre téléphone, ouvrez Appareils liés → Lier un appareil → Lier avec un numéro de téléphone à la place et saisissez le code.

Après la liaison, WhatsApp synchronise votre historique récent (jusqu'à environ 90 jours) vers l'appareil lié, ce qui peut prendre quelques minutes pour les comptes volumineux.

Forfaits

• Essai gratuit : toutes les fonctionnalités pendant 1 heure après la première liaison d'un téléphone.
• Forfait gratuit : après l'essai, la lecture, le résumé et la recherche de conversations ainsi que l'envoi de messages texte continuent de fonctionner. Les messages texte se terminent par « Sent via wa-mcp.com », et les nouvelles conversations (personnes qui ne vous ont pas écrit au cours des 90 derniers jours) ne peuvent pas être démarrées.
• Forfait payant : fichiers (photos, vidéos, notes vocales, documents), messages programmés, modification, réaction et suppression de messages, nouvelles conversations avec garde-fous anti-bannissement, et aucune mention.

Demandez à votre assistant « Quel est mon forfait ? » pour voir votre forfait et les options d'abonnement.

Outils

Votre assistant choisit les outils ; vous demandez simplement en langage naturel.

Lecture

Outil	Ce qu'il fait
get_recent_chats	Vos conversations les plus récentes, avec le dernier message de chacune.
get_unanswered_chats	Les conversations dont le dernier message provient de l'autre personne, pour voir qui attend une réponse.
read_chat_history	Les messages d'une conversation, d'une personne ou d'un groupe.
search_messages	Recherche le texte de vos messages, éventuellement dans une conversation ou auprès d'une personne.
search_contacts	Trouve un contact ou un groupe par nom ou par numéro.
download_media	Ouvre une photo, une note vocale, une vidéo, un document ou un autocollant à partir d'un message.
get_writing_style	Des exemples de votre façon d'écrire, pour que les brouillons rédigés pour vous vous ressemblent.

Écriture

Outil	Ce qu'il fait
send_message	Envoie un texte, ou un fichier depuis un lien, à une personne ou à un groupe. Affiche d'abord un indicateur de saisie.
schedule_message	Programme un message pour plus tard, une fois ou de façon récurrente (quotidien, hebdomadaire, mensuel, etc.).
list_scheduled_messages	Liste les messages programmés à venir et l'historique des messages passés.
cancel_scheduled_message	Annule un message programmé (toutes ses répétitions).
react_to_message	Réagit à un message avec un emoji, ou retire la réaction.
edit_message	Modifie le texte de l'un de vos propres messages.
delete_message	Supprime l'un de vos propres messages pour tout le monde.
mark_as_read	Marque une conversation comme lue.

Connexion et compte

Outil	Ce qu'il fait
get_session_status	Indique si votre WhatsApp est lié et connecté.
get_pairing_qr	Démarre la liaison avec un code QR.
request_pairing_code	Démarre la liaison avec un code d'appairage.
restart_session	Se reconnecte à WhatsApp si les messages cessent d'arriver.
manage_subscription	Affiche votre forfait et les options d'abonnement.
report_feedback	Nous envoie un rapport de bug ou une demande de fonctionnalité.
unlink_whatsapp	Dissocie votre WhatsApp (votre compte est conservé).
delete_account	Supprime votre compte et toutes ses données, après confirmation.

Exemples de requêtes

• « Qui attend une réponse de ma part depuis hier ? »
• « Résume ce dont le groupe de la famille a parlé cette semaine. »
• « Trouve le message où Carlos m'a envoyé l'adresse. »
• « Dis à Ana que la commande part jeudi. » (votre assistant affiche d'abord le brouillon, sauf si vous avez donné les mots exacts)
• « Chaque lundi à 9h, rappelle au groupe de l'équipe d'envoyer leur point hebdomadaire. »

Sécurité

• Vous gardez le contrôle de ce qui est envoyé. Lorsque votre assistant rédige un message pour vous, il vous montre le brouillon avant l'envoi, sauf si vous lui avez donné le texte exact.
• Garde-fous anti-bannissement. Les messages adressés à des personnes qui ne vous ont pas écrit au cours des 90 derniers jours sont espacés (au plus 1 par minute et 10 personnes différentes toutes les 12 heures), car c'est ce qui fait signaler les numéros comme spam. Les conversations avec des personnes qui vous ont écrit ne sont jamais limitées. Il n'existe aucun outil d'envoi en masse.
• Indicateur de saisie. Un court « en train d'écrire… » apparaît avant chaque message, comme si vous l'aviez tapé.

Dépannage

• « WhatsApp n'est pas lié » : l'appareil lié a été supprimé (depuis votre téléphone, ou par dissociation). Demandez à votre assistant de reconnecter votre WhatsApp avec le même numéro.
• Le code d'appairage ne fonctionne pas : les codes expirent après un court délai. Demandez-en un nouveau, vérifiez que le numéro inclut l'indicatif pays, et utilisez Lier avec un numéro de téléphone à la place sur votre téléphone.
• Les messages ont cessé d'arriver : demandez à votre assistant de redémarrer votre connexion WhatsApp. Si WhatsApp sur votre téléphone est hors ligne depuis environ 14 jours, WhatsApp déconnecte les appareils liés : ouvrez WhatsApp sur votre téléphone, puis liez à nouveau.
• « Cette connexion est définitivement enregistrée au numéro de téléphone… » : chaque connexion appartient à un seul téléphone. Pour utiliser un autre numéro, dissociez, puis retirez le connecteur et ajoutez-le à nouveau (ou, avec une URL personnelle, générez-en une nouvelle).
• Le connecteur indique qu'il n'est pas connecté (utilisateurs de l'annuaire) : retirez WhatsApp MCP de vos connecteurs et reconnectez-le, puis liez le même téléphone. Votre compte et votre abonnement sont conservés.

Confidentialité et vos données

Vos messages sont conservés pendant 90 jours sur nos serveurs afin que votre assistant puisse les rechercher, et ne sont jamais utilisés à des fins publicitaires ni pour l'entraînement d'IA. Ce que votre assistant lit est traité par son fournisseur selon sa politique. Demandez à votre assistant de dissocier votre WhatsApp ou de supprimer votre compte à tout moment ; la suppression efface tout immédiatement. Tous les détails figurent dans notre Politique de confidentialité et nos Conditions.