root@construct:~/open-source/whatsapp-mcp$
<-- voltar para /open-source
whatsapp-mcp

whatsapp-mcp

Fork do servidor MCP do WhatsApp que acrescenta gestão de grupos e comunidades à bridge em Go.

>O que é

O whatsapp-mcp liga um cliente de IA, como o Claude, à sua própria conta do WhatsApp. Uma bridge em Go conversa com o WhatsApp Web e guarda as mensagens na sua máquina, em SQLite; um servidor MCP em Python deixa o cliente buscar, ler e enviar mensagens. O projeto foi criado por Luke Harries e é mantido pela Very Good Plugins. Este é o meu fork da versão deles.

O fork acrescenta endpoints REST à bridge para grupos e comunidades: criar um grupo, uma comunidade ou um grupo dentro de uma comunidade, com aprovação para entrar se você quiser; adicionar e remover participantes; trocar o nome, a descrição e a foto de um grupo; listar os grupos de uma comunidade; ler os dados de um grupo e fotos de perfil; e apagar para todos uma mensagem sua. Eles usam o mesmo token da API da bridge. Ainda não há ferramentas MCP para eles, então a chamada é por HTTP.

Eu uso o fork na minha própria conta. Propus os endpoints de grupo e de foto de perfil ao projeto original. Para tudo que não é de grupo, use e dê estrela no upstream.

>Como começar

Precisa de Go 1.26+, e de Python 3.11+ com uv para o servidor MCP. O README explica a instalação completa.

git clone https://github.com/kayossouza/whatsapp-mcp.git
cd whatsapp-mcp/whatsapp-bridge
go run .   # leia o QR code em WhatsApp > Dispositivos conectados
curl -X POST http://127.0.0.1:8080/api/create-group \
  -H "Authorization: Bearer $(cat store/.bridge-token)" \
  -d '{"name": "Time de lançamento", "participants": ["15551234567"]}'

>Créditos

  • >Fork do verygoodplugins/whatsapp-mcp (MIT), de onde vêm a bridge, o servidor MCP e tudo que não é endpoint de grupo.
  • >A versão deles é um fork do lharries/whatsapp-mcp, de Luke Harries (MIT), o projeto original.
  • >A bridge fala com o WhatsApp pelo tulir/whatsmeow (MPL 2.0).
  • >As mudanças do fork estão sob a licença MIT.
Agendar diagnóstico · R$ 500Planos