Provides tools for interacting with WhatsApp, enabling sending text messages, images, documents, audio, video and stickers, reading received messages, checking delivery/read status, and managing messages with edits, deletions, reactions and presence updates.
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 send a WhatsApp message to my phone saying 'deploy finished successfully'"
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 para um assistente (ex.: Claude) mandar alertas no WhatsApp pessoal do
operador, com confirmação de entrega e observabilidade do canal. Usa
Baileys diretamente (sem Evolution API,
sem Postgres, sem Redis), rodando numa VM Compute Engine e2-micro sempre ligada
(Always Free tier do Google Cloud — custo ~R$0/mês).
Por que VM e não Cloud Run? A sessão WhatsApp Web exige um WebSocket persistente; o Cloud Run congela a CPU do container entre requisições. Ver
docs/ARQUITETURA.md.
Documento | Conteúdo |
Arquitetura no Google Cloud (VM e2-micro, Caddy+sslip.io, IP estático, systemd), auth, deploy e custo. | |
As 15 ferramentas MCP em detalhe (parâmetros, recomendadas × extras, confirmação de entrega). | |
A saga de bugs e seus fixes (405, git ownership, 9º dígito, OAuth, timing de deploy…). |
Contexto do ecossistema (os 3 MCPs, estudo de viabilidade, monitoria de custos): repo GoogleCloud_Projects.
Related MCP server: WAHA MCP Server
Toda ferramenta de envio confirma a entrega (espera o recibo do WhatsApp) e retorna
{ entregue, status, id }. Status: pendente → enviado_ao_servidor → entregue → lido. O ack
de entrega independe de recibos de leitura; o lido é best-effort. GET /health expõe a
mesma observabilidade (uptime check externo).
Ferramenta | O que faz |
| Texto (aceita markdown do WhatsApp: |
| Imagem — gráficos de payoff/curva de capital/IV Rank/print do cockpit. |
| PDF/CSV/XLSX — relatórios, auditoria, posições. |
| Two-way: lê as mensagens recebidas pelo robô (o operador comanda pelo WhatsApp; o assistente lê e age). |
| Reconfere entrega/leitura de um envio anterior. |
| Observabilidade do canal (online? desde quando? última entrega OK?). |
| Alerta falado: gera a fala do texto (Google TTS Neural pt-BR) e envia como nota de voz. Só aparece com |
| Guia para a LLM: como usar as ferramentas complexas, com exemplos e boas práticas. A própria IA chama quando tem dúvida. |
HABILITAR_FERRAMENTAS_EXTRAS)Implementadas para exploração futura; só aparecem/funcionam com HABILITAR_FERRAMENTAS_EXTRAS=true:
Ferramenta | O que faz |
| Envia áudio; com |
| Envia vídeo com legenda opcional. |
| Envia um sticker (idealmente webp). |
| Responde citando (reply/quote) uma mensagem recebida, pelo id de |
| Edita uma mensagem já enviada por este servidor (ex: marcar alerta como "resolvido"). |
| Apaga para todos uma mensagem já enviada (retratar alerta falso). |
| Reage com emoji a uma mensagem (recebida ou enviada). |
| Marca mensagens recebidas como lidas (uma específica, ou as últimas). |
| Envia presença ao destino: |
Para autorizar os extras (na VM):
echo 'HABILITAR_FERRAMENTAS_EXTRAS=true' | sudo tee -a /etc/systemd/system/whatsapp-mcp.env
sudo systemctl restart whatsapp-mcp(abra uma conversa nova no claude.ai para as novas ferramentas aparecerem).
⚠️ Cada capacidade "bot-like" a mais aumenta o risco de banimento da conexão não-oficial. Para um canal pessoal de alertas, mantenha só o necessário ligado.
Remetente (robô): número que escaneia o QR e mantém a sessão. Use um número secundário (reduz risco de banimento do principal).
Destino (WHATSAPP_DESTINO): onde os alertas chegam — seu número principal.
Se remetente == destino, a mensagem vai para o chat "Mensagem para mim". Use números diferentes.
Provisionado pelo script scripts/aplicar_whatsapp_mcp.sh do repo GoogleCloud_Projects,
que também cria a VM, o firewall, o IP estático e o HTTPS (Caddy + sslip.io). Este
repositório é publicado automaticamente por esse script.
Método/rota | Descrição |
| MCP autenticado pela chave no path — é esta a URL usada no conector do claude.ai: |
| MCP autenticado pelo header |
| Público: |
/etc/systemd/system/whatsapp-mcp.env na VM)Variável | Descrição |
| Chave exigida em |
| Número de destino, só dígitos ou JID ( |
| Porta interna do Node (padrão 8080; Caddy faz o HTTPS na frente). |
|
|
gcloud compute ssh whatsapp-mcp-vm --project=<PROJECT_ID> --zone=us-east1-b
sudo journalctl -u whatsapp-mcp -fEscaneie o QR com o celular remetente (WhatsApp → Aparelhos conectados → Conectar um aparelho).
A sessão fica salva em auth_info_baileys e reconecta sozinha.
A saga de bugs (405, dubious ownership do git, 9º dígito, número errado, OAuth do
conector) está documentada em docs/whatsapp-mcp-arquitetura.md no repo GoogleCloud_Projects
— leia antes de repetir os erros.
MIT — ver LICENSE.
This server cannot be deployed
Give your AI agents a real WhatsApp number to send and receive messages.
I send and manage WhatsApp Web messages through your linked session
WhatsMCP connects Claude and other MCP-compatible AI agents directly to WhatsApp. Send and receive text, images, documents, and voice notes; manage groups (create, add/remove members, promote admins); look up contacts and profiles; follow channels; and read call and message history — all through a standard MCP interface. For voice use cases, WhatsMCP offers SIP-based calling plans (inbound-only, or full inbound/outbound) so AI voice agents can answer and place WhatsApp calls, plus low-latency WebSocket integrations with voice agent providers like ElevenLabs. Multiple WhatsApp accounts can be paired and managed per workspace, with webhook support for real-time inbound message delivery to your own infrastructure.
Run WhatsApp Business campaigns from any AI assistant: contacts, segments, and broadcasts.
