rodrigopg/whatsapp-mcp
Developer toolsЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
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 Новичок в MCP? Начните с руководства на mcpskill.org →Конфигурация
{
"mcpServers": {
"whatsapp": {
"command": "{{PATH_TO_UV}}",
"args": [
"--directory",
"{{PATH_TO_SRC}}/whatsapp-mcp/whatsapp-mcp-server",
"run",
"main.py"
]
}
}
}