Pular para o conteúdo
NovidadesIA

Projetos de Código Aberto

Finereli lança servidor MCP open source para IA ler seus chats do WhatsApp

Ferramenta read-only em TypeScript roda em Cloudflare Workers, cifra mensagens com chave local e já soma 369 estrelas em seis dias.

Edição: Anderson Gomes
· 3 min de leitura

Finereli lança servidor MCP open source para IA ler seus chats do WhatsApp
Imagem: Reprodução · site do whatsapp-mcp · licença livre · licença MIT

O desenvolvedor Finereli lançou um servidor MCP read-only que permite que agentes de IA como ChatGPT e Claude acessem e pesquisem suas mensagens do WhatsApp. Criado há seis dias, o projeto já soma 369 estrelas no GitHub e usa criptografia local para proteger os dados. A ferramenta serve para quem quer integrar IA ao histórico de conversas sem expor conteúdo a terceiros.

Como o servidor lê seus chats sem mexer em nada

O servidor age como um dispositivo vinculado ao WhatsApp, mas só se conecta quando o agente de IA faz uma solicitação. Quando chega um pedido, ele estabelece conexão, baixa as mensagens desde a última vez que rodou, salva tudo em um banco SQLite dentro de um Durable Object do Cloudflare e encerra a sessão. Seu telefone continua funcionando normalmente e recebendo notificações.

Cada conta tem uma chave de dados aleatória que criptografa tudo: texto das mensagens, nomes de chats e contatos, nomes salvos pelo agente e até as chaves de sessão do WhatsApp. A chave é derivada de uma senha local — no caso de auto-hospedagem — ou do token OAuth do login via Google, no serviço hospedado. O servidor substitui números de telefone e IDs de chats por hashes para permitir buscas sem expor quem são os contatos. Timestamps, tipo de mensagem e lado que enviou ficam visíveis, mas o conteúdo e os participantes são mantidos em segredo.

A ferramenta não oferece nenhuma função para enviar, editar ou deletar mensagens. Enquanto processa um pedido, a chave fica na memória do servidor e as mensagens são trabalhadas em texto puro, mas o código é aberto para que qualquer um verifique que não há captura indevida de dados.

Do clique à primeira busca: como instalar e rodar

O serviço pronto em whatsapp.finereli.com oferece atalho para quem não quer lidar com infra. O usuário faz login com a conta Google, escaneia o QR code como se fosse vincular o WhatsApp Web e adiciona a URL https://whatsapp.finereli.com/mcp ao seu agente. A versão gratuita é beta, tem limite de vagas e restrição de tamanho por conta, mas as mensagens são cifradas em repouso.

Para auto-hospedagem, o setup começa com Node.js 18+, TypeScript e a ferramenta Wrangler instalada. Depois de clonar o repositório e rodar npm install, o usuário configura as variáveis de ambiente — principalmente OWNER_PASSWORD para definir a senha que derivará a chave de criptografia — e faz o deploy com wrangler deploy. O custo fica na casa de poucos dólares por mês na conta do Cloudflare, dependendo do uso.

Na primeira execução, o agente se autentica com a senha local e a ferramenta vincula o WhatsApp como um dispositivo novo usando o fluxo padrão do WhatsApp Web. Depois da primeira busca, as mensagens ficam disponíveis offline em um banco SQLite dentro de um Durable Object do Cloudflare, pronto para buscas rápidas do agente.

O projeto tem apenas seis dias de vida, mas já coleciona 369 estrelas no GitHub, 31 forks, uma issue aberta e mantém um commit diário desde o lançamento em 18 de outubro de 2026. A licença MIT permite uso comercial e modificação, mas a ferramenta não serve para quem precisa enviar mensagens pelo WhatsApp ou quer uma integração bidirecional. Quem não confia no serviço hospedado deve optar pela auto-hospedagem, onde a única chave de acesso vem de uma senha que só você conhece.

  • TypeScript
  • MIT
  • Projetos de Código Aberto
  • GitHub

Fonte: Repositório no GitHub · Como produzimos as matérias