Allows reading messages, listing chats, sending messages, and generating daily summaries of incoming WhatsApp messages.
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-mcp-skill list my recent WhatsApp chats"
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.
Servidor MCP que conecta o seu WhatsApp ao Claude Code, mais uma skill /whatsapp que sabe ler mensagens, resumir o dia e enviar mensagens com confirmação.
Funciona como o WhatsApp Web: você vincula a sessão escaneando um QR code uma vez. A sessão fica salva localmente na sua máquina e nunca sai dela. Por baixo usa whatsapp-web.js rodando um Chrome headless.
Ferramenta | O que faz |
| Lista chats recentes (nome, não lidas, última mensagem) |
| Lê mensagens de um chat por nome ou número |
| Envia mensagem (exige match exato do nome do chat) |
| Tudo que chegou hoje, agrupado por remetente |
Áudios são transcritos automaticamente se o Whisper estiver instalado (opcional).
Related MCP server: WhatsApp MCP Server
Node.js 18+
Google Chrome ou Chromium instalado
(Opcional) Whisper para transcrição de áudio
git clone https://github.com/alelopesjr-ai/whatsapp-mcp-skill.git ~/whatsapp-mcp-skill
cd ~/whatsapp-mcp-skill
npm installnode auth.jsVai aparecer um QR code no terminal (e abrir uma imagem qr.png). No celular: WhatsApp > Dispositivos vinculados > Vincular dispositivo, escaneie. Quando aparecer Connected., pode fechar o terminal (Ctrl+C). A sessão fica salva em .wwebjs_auth/ (não versionada).
claude mcp add whatsapp -- node ~/whatsapp-mcp-skill/index.jsConfira com claude mcp list. Troque ~/whatsapp-mcp-skill se você clonou em outro lugar.
Copie a skill para o seu projeto (ou para ~/.claude/skills/ para deixá-la global):
mkdir -p ~/.claude/skills/whatsapp
cp ~/whatsapp-mcp-skill/skill/SKILL.md ~/.claude/skills/whatsapp/SKILL.mdA skill assume o caminho de exemplo ~/whatsapp-mcp-skill. Se você clonou em outro lugar, ajuste os caminhos dentro do SKILL.md.
Pronto. No Claude Code, use /whatsapp ou peça em linguagem natural ("lê o que o fulano me mandou no zap").
browser is already running / SingletonLock — sobrou um Chrome órfão segurando o lock. Geralmente basta tentar de novo. Se persistir:
pkill -f "whatsapp-mcp-skill/index.js"; pkill -f "wwebjs_auth/session"
rm -f ~/whatsapp-mcp-skill/.wwebjs_auth/session/Singleton*auth_failure / pedindo QR de novo — a sessão caiu. Pare qualquer instância do servidor (pkill -f "whatsapp-mcp-skill/index.js") e rode node auth.js de novo.
Tudo roda localmente. A sessão (.wwebjs_auth/) fica só na sua máquina e está no .gitignore. Nenhuma mensagem passa por servidor de terceiros além da própria infra do WhatsApp.
Isso usa uma biblioteca não oficial (whatsapp-web.js) que automatiza o WhatsApp Web. Não é endossado pelo WhatsApp/Meta. Use por sua conta e risco e com bom senso.
This server cannot be deployed
Drive your real WhatsApp inbox from Claude — send, reply, label, assign, and triage via TimelinesAI.
Connect a personal/Business WhatsApp account via QR pairing (multi-device, like WhatsApp Web). Send
Drive WhatsApp from any MCP client: pair devices, send text and media, manage contacts and groups.
WhatsApp CRM for AI agents: search contacts, read chats, manage the sales pipeline, send messages.
