WhatsApp MCP Server — community fork with LID contact fixes, group management, security hardening, and contact name resolution
概览
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
以下为原文 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.
Independent, maintained project originally based on lharries/whatsapp-mcp.
This is a Model Context Protocol (MCP) server for WhatsApp.
With this you can search and read your personal WhatsApp messages (including images, videos, documents, and audio messages), search your contacts and send messages to either individuals or groups. You can also create and leave groups.
It connects to your personal WhatsApp account directly via the WhatsApp web multidevice API (using the whatsmeow library). All your messages are stored locally in a SQLite database and only sent to an LLM (such as Claude) when the agent accesses them through tools (which you control).
Caution: as with many MCP servers, the WhatsApp MCP is subject to the lethal trifecta. Prompt injection could lead to private data exfiltration.
Highlights
Bug fixes & compatibility
- whatsmeow API updated — the upstream bridge broke when whatsmeow added
context.Contextto all API calls. Fixed across all call sites. - PNG QR fallback — QR code is saved to
/tmp/whatsapp-qr.pngand opened automatically on macOS if the terminal rendering is hard to scan.
Security
安装
This server does not publish a one-line install command.
Open the repository installation guide 新手？先看 mcpskill.org 教程 →配置
{
"mcpServers": {
"whatsapp": {
"command": "{{PATH_TO_UV}}",
"args": [
"--directory",
"{{PATH_TO_SRC}}/whatsapp-mcp/whatsapp-mcp-server",
"run",
"main.py"
]
}
}
}