whatsapp-mcp-skill
Allows reading messages, listing chats, sending messages, and generating daily summaries of incoming WhatsApp messages.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
WhatsApp MCP + Skill
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.
Ferramentas
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
Pré-requisitos
Node.js 18+
Google Chrome ou Chromium instalado
(Opcional) Whisper para transcrição de áudio
Instalação
git clone https://github.com/alelopesjr-ai/whatsapp-mcp-skill.git ~/whatsapp-mcp-skill
cd ~/whatsapp-mcp-skill
npm install1. Autenticar (vincular o WhatsApp)
node 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).
2. Registrar o MCP no Claude Code
claude mcp add whatsapp -- node ~/whatsapp-mcp-skill/index.jsConfira com claude mcp list. Troque ~/whatsapp-mcp-skill se você clonou em outro lugar.
3. Instalar a skill
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").
Resolução de problemas
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.
Privacidade
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.
Aviso
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.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Your own WhatsApp in Claude and ChatGPT: read chats, draft replies, send messages you approve.
WhatsApp for Claude, ChatGPT or any AI agent: search, reply and send. Personal or Business API.
Link a WhatsApp number by QR code and use it from Claude or ChatGPT via MCP.
Let Claude or ChatGPT search, read and send your WhatsApp messages over MCP. OAuth sign-in.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables Claude Code to interact with WhatsApp for reading messages, sending replies, and searching contacts through the Model Context Protocol. It uses whatsapp-web.js to facilitate local connection management with QR code authentication and session persistence.4MIT
- AlicenseAqualityBmaintenanceEnables Claude to read and send WhatsApp messages, including media and call history, via a local bridge.13MIT
- AlicenseNot gradedqualityDmaintenanceEnables bidirectional communication with Claude via WhatsApp, allowing commands, file sharing, and persistent context without needing Claude Code open.6 npm1MIT
- AlicenseNot gradedqualityDmaintenanceConnects WhatsApp to Claude Code, enabling message reading, audio transcription, image analysis, and message sending with full codebase context.49 npmMIT