O que é WhatsApp MCP (finereli)?
WhatsApp MCP, de Eli Finer (finereli no GitHub), conecta-se à sua conta do WhatsApp como aparelho conectado, do mesmo jeito que o WhatsApp Web, importa o histórico que o WhatsApp entrega a um aparelho novo e permite que um cliente MCP liste conversas, leia, pesquise em todas, encontre as que você não respondeu e busque fotos, áudios e documentos. Ele não pode enviar, editar nem apagar nada; não existe ferramenta para isso.
Ele roda como Cloudflare Worker com um Durable Object por pessoa, ou na sua própria máquina com Docker. Você pode usar o beta hospedado grátis em whatsapp.finereli.com, que faz login com Google e tem vagas limitadas, ou implantar sua própria cópia com uma senha que só você conhece. O repositório é TypeScript com licença MIT, criado em 18 de outubro de 2026, com cerca de 415 estrelas e commits até 10 de novembro de 2026. Ele conversa com o WhatsApp pela biblioteca não oficial Baileys, fixada numa release candidate.
Como instalar WhatsApp MCP (finereli)
https://whatsapp.finereli.com/mcpWhatsApp MCP (finereli) vale a pena?
São as escolhas de projeto que justificam esta análise. Não há ferramenta de envio, de propósito, o que elimina a pior falha de um agente de mensagens. Mensagens, nomes de conversas e contatos e as próprias chaves de sessão do WhatsApp são criptografados em repouso sob uma chave de dados aleatória, que por sua vez fica embrulhada por uma chave derivada da sua senha (PBKDF2-SHA256, 600,000 rodadas) ou do serviço de login hospedado. Números de telefone são guardados como hashes com chave, e a busca usa filtros por bloco de cerca de 128 mensagens, de modo que um banco copiado mostra padrões de atividade e tamanhos de mensagem, mas não quem nem o quê.
O README é incomumente claro sobre onde essa proteção termina, e o leitor também deve ser. Não é criptografia de ponta a ponta: enquanto seu agente consulta, o servidor guarda a chave e lê suas mensagens em texto puro, e o que o agente lê vai para o provedor de modelos dele. No beta hospedado, o operador mantém o serviço de login e poderia derivar sua chave; só uma cópia auto-hospedada com OWNER_PASSWORD elimina isso. Não há etapa de confirmação antes de um agente ler uma conversa, e todas as pessoas dessas conversas estão na cópia sem terem concordado.
O risco para a conta é real, embora pequeno. Ele usa o protocolo do WhatsApp Web via Baileys, algo que os termos do WhatsApp desaconselham, e o autor avisa que o WhatsApp poderia restringir ou encerrar uma conta que faz isso. Contas hospedadas se conectam a partir de endereços de data center da Cloudflare, o que pode chamar mais atenção do que um telefone. A sincronização só acontece quando um agente pede, porque nada consegue descriptografar sem você logado; o WhatsApp só guarda mensagens para um aparelho conectado por tempo limitado, então uma pausa longa pode exigir reconectar.
O rival é lharries/whatsapp-mcp, com cerca de 6,870 estrelas o servidor mais conhecido, mas ele pode enviar mensagens e não recebe commit desde julho de 2025. Este tem menos de um mês, foi testado em uma única conta real segundo o próprio autor, e edições e exclusões seguem sem teste. Auto-hospedar na Cloudflare custa $5 por mês e alguns minutos com o wrangler, e é a versão a que confiaríamos um histórico pessoal.
Onde ele se destaca
Uma mãe que equilibra grupos da escola, do esporte e da família
Saber o que o grupo da família decidiu nesta semana
Peça ao agente um resumo do grupo desde segunda; ele atualiza a partir do WhatsApp se a cópia tiver mais de dez minutos e depois lê a conversa. Grátis no beta hospedado; $5 por mês auto-hospedado.
Um designer freelancer que combina trabalhos com clientes pelo WhatsApp
Achar o que um cliente disse sobre o briefing e o prazo
search_messages aceita várias consultas de palavras exatas de uma vez em todas as conversas, e get_media busca o PDF anexado. A busca é por palavras inteiras, sem aproximação, então peça 'deadline' e 'invoice*' em vez de uma paráfrase.
Um autônomo que atende clientes por um número pessoal
Ver quais clientes ainda esperam resposta
unanswered_chats lista as conversas diretas em que a outra pessoa escreveu por último. O agente rascunha respostas para você enviar pelo telefone, já que o servidor em si não envia.
Antes de decidir
- Configuração
- Hospedado: faça login com Google em whatsapp.finereli.com, leia o QR code em Aparelhos conectados no WhatsApp e adicione https://whatsapp.finereli.com/mcp. Auto-hospedado: clone, npm install, crie um namespace KV, defina OWNER_PASSWORD (12+ caracteres) e npm run deploy, ou docker compose up atrás de um proxy TLS.
- Integrações
- 11 ferramentas: list_chats, get_messages, search_messages, unanswered_chats, get_media, transcribe_audio, unnamed_chats, set_contact_names, sync_now, link_status e relink. Funciona com Claude, ChatGPT, Grok e outros clientes MCP remotos via OAuth.
- Dados e privacidade
- Mensagens guardadas em SQLite dentro de um Durable Object da Cloudflare, criptografadas com AES-256-GCM em repouso; horários, tipos de mensagem e tamanhos aproximados continuam legíveis. Descriptografadas em memória durante as requisições. Mídias são buscadas sob demanda, não guardadas. Apagar pelo painel remove tudo.
- Custo em escala
- Auto-hospedado para uma pessoa: o plano Workers Paid de $5/mês. Como serviço, o README estima cerca de $10 por mês no pior caso para 100 pessoas com os limites padrão, mais provavelmente de $5 a $7.
- Limites
- Contas hospedadas limitadas por padrão a 250,000 mensagens e 300 MB; importa só o que o WhatsApp envia a um aparelho novo, uma vez por conexão; busca por palavras exatas; algumas conversas aparecem como números até receberem nome.
O que é bom
- Somente leitura: sem ferramentas para enviar, editar ou apagar
- Criptografado em repouso; números guardados como hashes com chave
- Auto-hospedável na Cloudflare ou Docker com sua própria senha
- Apague tudo e desconecte pelo painel
O que não é
- Protocolo não oficial; o WhatsApp pode restringir a conta
- Operador do beta hospedado pode derivar sua chave
- Texto puro na memória durante cada requisição
- Menos de um mês de vida; testado em uma conta real
Ideal para
Pessoas que querem que um agente encontre coisas no seu histórico pessoal do WhatsApp e topam auto-hospedar pela privacidade que isso traz.
Alternativas ao WhatsApp MCP (finereli)
WhatsApp MCP (finereli): perguntas frequentes
- WhatsApp MCP (finereli) vale a pena?
- Um jeito bem pensado e somente leitura de deixar um agente pesquisar no seu WhatsApp, desde que você rode sua própria cópia e aceite o risco para a conta que os termos do WhatsApp implicam. Damos nota 3.8 de 5.
- Quanto custa WhatsApp MCP (finereli)?
- Gratuito e de código aberto (MIT). Beta hospedado grátis com vagas limitadas. Auto-hospedar na Cloudflare exige o plano Workers Paid de $5/mês; transcrever áudios custa cerca de $0.0005 por minuto no Workers AI.
- Quais são as desvantagens de WhatsApp MCP (finereli)?
- Protocolo não oficial; o WhatsApp pode restringir a conta; operador do beta hospedado pode derivar sua chave; texto puro na memória durante cada requisição; menos de um mês de vida; testado em uma conta real.
- Para quem WhatsApp MCP (finereli) é indicado?
- Pessoas que querem que um agente encontre coisas no seu histórico pessoal do WhatsApp e topam auto-hospedar pela privacidade que isso traz.
- Quanto custa WhatsApp MCP (finereli) para uma equipe ou em produção?
- Auto-hospedado para uma pessoa: o plano Workers Paid de $5/mês. Como serviço, o README estima cerca de $10 por mês no pior caso para 100 pessoas com os limites padrão, mais provavelmente de $5 a $7.
- WhatsApp MCP (finereli) é seguro para dados da empresa?
- Mensagens guardadas em SQLite dentro de um Durable Object da Cloudflare, criptografadas com AES-256-GCM em repouso; horários, tipos de mensagem e tamanhos aproximados continuam legíveis. Descriptografadas em memória durante as requisições. Mídias são buscadas sob demanda, não guardadas. Apagar pelo painel remove tudo.
- Quais são as melhores alternativas ao WhatsApp MCP (finereli)?
- As alternativas mais próximas que analisamos são Slack MCP Server e Google Workspace MCP servers.
Respostas verificadas em 13 de nov. de 2026.