WhatsApp MCP Server — community fork with LID contact fixes, group management, security hardening, and contact name resolution
Overview
Peça "o que ficou pendente hoje?" ou "responde o João que eu chego às 15h". - Lê e busca suas conversas, áudios (transcreve) e arquivos - Envia mensagens, áudios e arquivos, em contatos e grupos - Mostra o que ficou : quem te cobrou e o que você prometeu - Resumo da manhã: só o que precisa da sua ação hoje - Cria o conjunto de dados da para clonar (/whatsapp-mcp:clone) O setup guia o resto: instala, mostra um QR code e você escaneia com o celular (Aparelhos conectados). Pronto. - Suas mensagens ficam (banco local). Só vão para a IA quando você pede. - Uma mensagem maliciosa pode tentar enganar a IA ("prompt injection"). Para acesso remoto, use o modo somente leitura (MCP_READONLY=true). - Projeto independente, código aberto, não é do WhatsApp/Meta. Use por sua conta e risco. Ajuda: abra uma issue. Segurança: SECURITY.md. Parte técnica (nerd / para I.A. ler) — English, documentação completa Independent, maintained project originally based on lharries/whatsapp-mcp.
README
WhatsApp para o Claude
Seu WhatsApp dentro do Claude (ou ChatGPT). Peça “o que ficou pendente hoje?” ou “responde o João que eu chego às 15h”.
O que faz
- Lê e busca suas conversas, áudios (transcreve) e arquivos
- Envia mensagens, áudios e arquivos, em contatos e grupos
- Mostra o que ficou pendente: quem te cobrou e o que você prometeu
- Resumo da manhã: só o que precisa da sua ação hoje
- Cria o conjunto de dados da sua voz para clonar (
/whatsapp-mcp:clone)
Instalar (Claude Code)
/plugin marketplace add rodrigopg/claude-plugins
/plugin install whatsapp-mcp@rodrigopg
/whatsapp-mcp:setup
O setup guia o resto: instala, mostra um QR code e você escaneia com o celular (Aparelhos conectados). Pronto.
Seguro?
- Suas mensagens ficam no seu computador (banco local). Só vão para a IA quando você pede.
- Uma mensagem maliciosa pode tentar enganar a IA (“prompt injection”). Para acesso remoto, use o modo somente leitura (
MCP_READONLY=true). - Projeto independente, código aberto, não é do WhatsApp/Meta. Use por sua conta e risco.
Ajuda: abra uma issue. Segurança: SECURITY.md.
Install
This server does not publish a one-line install command.
Open the repository installation guide New to MCP? Start with the mcpskill.org guide →Configuration
{
"mcpServers": {
"whatsapp": {
"command": "{{PATH_TO_UV}}",
"args": [
"--directory",
"{{PATH_TO_SRC}}/whatsapp-mcp/whatsapp-mcp-server",
"run",
"main.py"
]
}
}
}