WhatsApp ganha integração nativa com IA via protocolo MCP

O repositório lharries/whatsapp-mcp oferece uma ponte entre o WhatsApp e assistentes de inteligência artificial por meio do protocolo MCP (Model Context Protocol). Desenvolvido pelo engenheiro Luke Harries, a ferramenta permite que modelos de linguagem como o Claude acessem, pesquisem e enviem mensagens pelo WhatsApp — tudo com os dados armazenados localmente em um banco SQLite. A abordagem prioriza privacidade ao evitar o envio automático de informações para servidores externos, exigindo autorização explícita do usuário para cada interação. Lançado em março de 2025, o projeto já acumula 6.750 estrelas no GitHub e 1.450 forks, com forte adesão desde sua primeira release em abril do mesmo ano.

---

Dados rápidos

• Repositório: lharries/whatsapp-mcp
• Licença: MIT
• Linguagem principal: Go (com componente Python para o servidor MCP)
• Estrelas/Forks: 6.750 | 1.450
• Última atualização: 13/07/2025
• Data da consulta: 28/10/2026

---

Uma ponte entre WhatsApp e IA sem nuvem

O WhatsApp MCP Server resolve um desafio comum para desenvolvedores e usuários avançados: como integrar o WhatsApp — aplicativo de mensagens mais usado no Brasil — a assistentes de IA sem depender de soluções proprietárias ou armazenamento em nuvem de terceiros. A solução funciona como um middleware que se conecta diretamente à API multidevice do WhatsApp via biblioteca whatsmeow, autenticando-se por QR code e mantendo todos os dados armazenados localmente. Diferente de bots convencionais que exigem servidores externos para processar mensagens, este projeto opera inteiramente na máquina do usuário, acessando os dados apenas quando solicitado por um agente de IA como o Claude.

A arquitetura é dividida em duas partes: um bridge em Go que gerencia a conexão com o WhatsApp e um servidor MCP em Python que padroniza as ferramentas para interação com o assistente. Essa separação permite que o componente Go — responsável pela autenticação e armazenamento — seja compilado para diferentes sistemas, enquanto o servidor MCP expõe funções como busca de contatos, leitura de mensagens e envio de arquivos de forma segura.

---

Como instalar e configurar em três etapas

O processo de instalação exige familiaridade com linha de comando e gerenciamento de dependências. Primeiro, é necessário instalar o Go, Python 3.6+, o gerenciador de pacotes UV e, opcionalmente, o FFmpeg para manipulação de áudio. Em sistemas Windows, a configuração é mais complexa devido à necessidade de ativar o CGO para compilar a biblioteca go-sqlite3.

Os passos básicos são:

1. Clonar o repositório e navegar até a pasta whatsapp-bridge
2. Compilar e executar o bridge em Go, que apresentará um QR code para autenticação no WhatsApp
3. Configurar o cliente MCP (Claude Desktop ou Cursor) com o caminho para o servidor Python

A autenticação via QR code é temporária: a cada cerca de 20 dias, o usuário precisará repetir o processo. O projeto recomenda atenção especial à configuração do CGO em Windows, pois a ausência desse recurso resulta em erros de compilação.

--- ## Cinco casos de uso para o WhatsApp MCP

• Pesquisa avançada em mensagens: Usar o assistente para buscar informações específicas em conversas antigas, como recibos ou links compartilhados, sem copiar manualmente o histórico.
• Respostas automatizadas com contexto: Configurar o Claude para responder a mensagens recebidas com base em informações armazenadas localmente, como histórico de pedidos ou dados de clientes.
• Envio programado de relatórios: Gerar relatórios em PDF ou planilhas e enviá-los automaticamente para grupos ou contatos específicos, com o assistente formatando o conteúdo.
• Análise de sentimentos em tempo real: Processar mensagens recebidas para identificar padrões emocionais ou palavras-chave, auxiliando em atendimentos ou monitoramento de equipes.
• Backup e migração de dados: Exportar mensagens e mídias para outros sistemas ou formatos, aproveitando as ferramentas de busca e filtragem do MCP para localizar arquivos específicos.

--- ## O que diferencia o projeto de alternativas

Enquanto soluções como Twilio API ou WhatsApp Business Platform exigem cadastro em serviços de terceiros e pagamento por uso, o WhatsApp MCP Server opera localmente e sem custos. Outra vantagem é a integração direta com o protocolo MCP, que padroniza a comunicação entre modelos de linguagem e ferramentas externas, facilitando a adoção por desenvolvedores acostumados a ecossistemas como o Claude Code ou Cursor.

Diferente de projetos que replicam a API do WhatsApp de forma não oficial — como WhatsApp Web via navegador —, este servidor usa a biblioteca whatsmeow, mantida ativamente e compatível com a API oficial do WhatsApp. A abordagem também evita problemas legais associados a scraping ou engenharia reversa da aplicação móvel.

--- ## Riscos e cuidados necessários

O projeto alerta para um risco conhecido no ecossistema MCP: a tríade mortal (lethal trifecta), onde injeção de código malicioso no servidor poderia resultar em vazamento de dados privados. Embora o armazenamento local mitigue parte desse risco, a autenticação via QR code e a execução de código na máquina local exigem atenção redobrada em ambientes compartilhados.

Outras limitações incluem:

• Dependência de autenticação periódica: A cada 20 dias, o usuário deve reautenticar o dispositivo, interrompendo temporariamente o acesso.
• Requisitos de sistema: Em Windows, a configuração exige um compilador C e ativação do CGO, o que pode ser complexo para usuários iniciantes.
• Maturidade do projeto: Com última atualização em julho de 2025 e 261 issues abertas, o código ainda está em fase inicial de desenvolvimento.
• Suporte limitado a mídias: Arquivos de áudio só podem ser enviados como mensagens de voz se estiverem no formato .ogg Opus ou se o FFmpeg estiver instalado para conversão.
• Sem suporte oficial: Não há garantias de compatibilidade com futuras versões da API do WhatsApp, o que pode exigir manutenção constante por parte da comunidade.

---

Resumo rápido

• Projeto: WhatsApp MCP Server — integração local entre WhatsApp e assistentes de IA via protocolo MCP
• Licença: MIT, permitindo uso comercial e modificações
• Linguagem: Go (principal) + Python (servidor MCP)
• Estrelas: 6.750 no GitHub
• Última atualização: 13/07/2025
• Risco principal: Vazamento de dados por injeção de código (tríade mortal) e necessidade de reautenticação periódica

---

Fontes

• Repositório oficial no GitHub
• Release v0.0.1
• Homepage do projeto (post no X/Twitter)