WhatsApp MCP
Allows AI agents to interact with a WhatsApp account: send and read messages, list chats, contacts and groups, manage group participants and chat state, react to messages, create polls, and search message history.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@WhatsApp MCPSend 'Cheguei!' to +5511999999999"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
WhatsApp para Claude, ChatGPT e agentes de IA
Conecte uma conta de WhatsApp pessoal/Business via pareamento por QR (multi-device, como o WhatsApp Web). Envie e leia mensagens, listas chats, contatos, grupos e faça busca full-text no histórico. Suporte opcional a proxy SOCKS5/HTTPS por conexão, recomendado para evitar bloqueios em IPs de datacenter (Cloudflare/AWS).
📊 41 ferramentas
✏️ Leitura e escrita
💬 Funciona com qualquer cliente MCP: Claude Desktop, Cursor, VS Code, Cline, Continue
🔑 Login via magic-link (sem senha)
English version · Documentação completa · Skill pra agentes
Instalar em 1 clique
Claude (Web e Desktop)
A Anthropic unificou a instalação de MCPs em claude.ai/customize/connectors. O mesmo link serve pra Claude Web e Claude Desktop (basta estar logado):
Manual (se o deeplink não abrir): claude.ai/customize/connectors → + → Adicionar conector personalizado → cole Nome WhatsApp e URL https://api.mcp.ai/p_whatsapp.
Cursor
VS Code (Copilot Chat)
➕ Instalar WhatsApp no VS Code
ChatGPT, Manus, OpenClaw e mais 40+ clientes
Funciona em qualquer cliente MCP que suporte MCP over HTTP. A URL do servidor é sempre:
https://api.mcp.ai/p_whatsappDetalhes por cliente: INSTALL.md.
Related MCP server: whatsapp-mcp
Exemplos de uso
Liste meus últimos 20 chats no WhatsApp
Busque no histórico todas as mensagens que mencionem 'reunião'
Envie 'Cheguei!' para +551199999999941 ferramentas disponíveis
Tool | Descrição |
| List WhatsApp accounts paired to this install — wa_jid, phone, label, proxy on/off, status. |
| Refresh this account's local data from WhatsApp — pulls recent messages and refreshes the groups/contacts lists into the local store. |
| Send a WhatsApp message (text or media). |
| Send a WhatsApp message (text or media). |
| List WhatsApp chats (individual + group). |
| List messages in a chat from LOCAL history. |
| Mark messages as read in a chat. |
| Read WhatsApp contacts. Actions: - list: search across contacts (query optional — substring on name/phone). Default limit 50. - get: full contact info by JID. [Flattened action: list] |
| Read WhatsApp contacts. Actions: - list: search across contacts (query optional — substring on name/phone). Default limit 50. - get: full contact info by JID. [Flattened action: get] |
| List WhatsApp groups the account belongs to — subject, jid, participants count, owner. |
| List the members of a WhatsApp group (live). |
| Manage participants of a WhatsApp group (the connected account must be a group admin). |
| Manage participants of a WhatsApp group (the connected account must be a group admin). |
| Manage participants of a WhatsApp group (the connected account must be a group admin). |
| Manage participants of a WhatsApp group (the connected account must be a group admin). |
| React to a message with an emoji (or remove your reaction by passing an empty emoji). |
| Send a poll or vote on one. Actions: - create: { to, name, options[] (2–12), selectable_count? } - vote: { chat_jid, message_id, options[] (the option texts to select) } [Flattened action: create] Bulk support: accept… |
| Send a poll or vote on one. Actions: - create: { to, name, options[] (2–12), selectable_count? } - vote: { chat_jid, message_id, options[] (the option texts to select) } [Flattened action: vote] Bulk support: accepts… |
| Manage a message you can act on. |
| Manage a message you can act on. |
| Manage a message you can act on. |
| Get metadata for a single chat (subject/name, archived/pinned/muted state, unread count, timestamps). |
| Change a chat's state. action: archive/unarchive, pin/unpin, mute/unmute. Requires chat_jid. [Flattened action: archive] |
| Change a chat's state. action: archive/unarchive, pin/unpin, mute/unmute. Requires chat_jid. [Flattened action: unarchive] |
| Change a chat's state. action: archive/unarchive, pin/unpin, mute/unmute. Requires chat_jid. [Flattened action: pin] |
| Change a chat's state. action: archive/unarchive, pin/unpin, mute/unmute. Requires chat_jid. [Flattened action: unpin] |
| Change a chat's state. action: archive/unarchive, pin/unpin, mute/unmute. Requires chat_jid. [Flattened action: mute] |
| Change a chat's state. action: archive/unarchive, pin/unpin, mute/unmute. Requires chat_jid. [Flattened action: unmute] |
| Group lifecycle/admin (the connected account must be a group admin for most actions). |
| Group lifecycle/admin (the connected account must be a group admin for most actions). |
| Group lifecycle/admin (the connected account must be a group admin for most actions). |
| Group lifecycle/admin (the connected account must be a group admin for most actions). |
| Group lifecycle/admin (the connected account must be a group admin for most actions). |
| Group lifecycle/admin (the connected account must be a group admin for most actions). |
| Full-text search across all stored messages (SQLite FTS5). |
| Show how far back the LOCAL message archive reaches per chat (oldest_ts, newest_ts, message_count, status). |
| Request OLDER messages for a chat from your phone (on-demand history sync), extending what whatsapp_messages can read. |
| Show this WhatsApp install's outbound webhook: the current URL, the subscribed events (empty = all), include_result, and the catalog of subscribable events (available_events — e.g. |
| Set (or remove) this WhatsApp install's outbound webhook. |
| Show this install's editable-after-connect settings per connected number — currently the proxy (proxy_url): whether it's set and a masked preview (the raw value is never returned). |
| Change an editable-after-connect setting on a connected number WITHOUT re-pairing. |
Detalhe de cada tool: docs/ferramentas.md
Preços
Cobrança por conexão ativa. Veja docs/precos.md.
Privacidade & LGPD
Sub-processadores: o LLM host que você escolher (Claude, ChatGPT, Cursor, agente próprio). Lista completa em docs/privacidade-lgpd.md.
Os dados retornados pelas tools são enviados ao LLM host que você escolher, sub-processador fora do nosso controle. Recomendamos planos com opt-out de treinamento.
Perguntas frequentes
O servidor é open source? O servidor é proprietário (hosted). Este repositório é o wrapper público com manifestos, docs e skills — tudo MIT.
Posso usar com agente próprio (não Claude/Cursor)?
Sim — qualquer cliente que suporte MCP over HTTP. URL: https://api.mcp.ai/p_whatsapp.
Suporte
Licença
MIT — veja LICENSE. O servidor MCP em api.mcp.ai/p_whatsapp é proprietário (hosted); este repositório (manifestos, docs, skills) é MIT.
This server cannot be deployed
Maintenance
Related MCP Connectors
Drive WhatsApp from any MCP client: pair devices, send text and media, manage contacts and groups.
WhatsApp (Web + Business API), SMS, contacts, and call records via 2Chat's MCP server.
Let Claude or ChatGPT search, read and send your WhatsApp messages over MCP. OAuth sign-in.
Your own WhatsApp as an MCP server: read, search and send from any MCP client.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables sending messages, managing templates, uploading media, and configuring webhooks for WhatsApp Business via the MCP protocol.9 npm5MIT
- AlicenseNot gradedqualityBmaintenanceEnables sending WhatsApp messages from MCP clients using a personal WhatsApp account via WebSocket protocol, without needing the Business API or browser automation.29 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables programmatic WhatsApp automation through MCP, including sending messages, managing chats and contacts, searching conversation history, and exchanging media files.MIT
- AlicenseNot gradedqualityAmaintenanceEnables connecting a personal WhatsApp number to any MCP client, providing tools to send, search, and manage WhatsApp messages, with an optional auto-reply feature.4MIT