Whasapo

Whasapo

Servidor MCP do WhatsApp. Envie e leia mensagens do WhatsApp a partir de qualquer assistente de IA compatível com MCP — Claude desktop, Claude Code, OpenClaw e outros.

Instalação

macOS / Linux:

curl -sSL https://raw.githubusercontent.com/toloco/whasapo/main/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/toloco/whasapo/main/install.ps1 | iex

Isso irá:

1. Baixar o binário mais recente para a sua plataforma
2. Configurar o aplicativo Claude desktop
3. Orientar você na vinculação da sua conta do WhatsApp (leitura do QR code)

Após a instalação, reinicie o seu aplicativo de IA.

Configuração por aplicativo

Claude Desktop

O instalador configura isso automaticamente. Se precisar fazer manualmente, adicione em ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "whatsapp": {
      "command": "~/.whasapo/whasapo",
      "args": ["serve"]
    }
  }
}

Reinicie o Claude Desktop. As ferramentas do WhatsApp estarão disponíveis imediatamente.

Claude Code

Adicione o servidor MCP ao seu projeto ou às configurações globais:

claude mcp add whatsapp ~/.whasapo/whasapo serve

Ou adicione em ~/.claude/settings.json:

{
  "mcpServers": {
    "whatsapp": {
      "command": "~/.whasapo/whasapo",
      "args": ["serve"]
    }
  }
}

OpenClaw

Nas configurações do OpenClaw, adicione um novo servidor MCP:

• Nome: whatsapp
• Comando: ~/.whasapo/whasapo
• Argumentos: serve

Ou adicione ao seu arquivo de configuração do OpenClaw:

{
  "mcpServers": {
    "whatsapp": {
      "command": "~/.whasapo/whasapo",
      "args": ["serve"]
    }
  }
}

Qualquer cliente compatível com MCP

O Whasapo é um servidor MCP padrão que usa transporte stdio. Aponte qualquer cliente MCP para:

command: ~/.whasapo/whasapo
args: serve

O que você pode fazer com ele?

Pergunte ao seu assistente de IA coisas como:

• "Mostre minhas mensagens recentes do WhatsApp"
• "Envie uma mensagem do WhatsApp para o João dizendo que vou me atrasar 10 minutos"
• "Quais mensagens recebi no grupo da família?"
• "Encontre meu contato chamado Sarah"
• "Responda à última mensagem da minha mãe agradecendo"
• "Resuma o que perdi no grupo de trabalho"

Ferramentas disponíveis

Ferramenta	Descrição
send_message	Envia uma mensagem de texto para um contato ou grupo
list_chats	Lista conversas recentes com prévia da última mensagem
get_messages	Obtém mensagens, opcionalmente filtradas por conversa
search_contacts	Busca contatos por nome ou número de telefone

Comandos

whasapo pair        Link your WhatsApp account (QR code)
whasapo serve       Start the MCP server (your AI app does this automatically)
whasapo status      Check if everything is working
whasapo update      Update to the latest version
whasapo uninstall   Remove whasapo completely
whasapo version     Print version

Solução de problemas

"O Claude não mostra as ferramentas do WhatsApp" Reinicie o aplicativo após a instalação.

"Não pode ser aberto porque a Apple não consegue verificar se há software malicioso" Execute isto e tente novamente:

xattr -d com.apple.quarantine ~/.whasapo/whasapo

"Falha na conexão" ou "não pareado" Sua vinculação do WhatsApp pode ter expirado. Vincule novamente:

whasapo pair

"Nenhuma mensagem encontrada" Mensagens anteriores à primeira instalação não aparecerão. Após a instalação, as mensagens são armazenadas de forma persistente e sobrevivem a reinicializações.

Desinstalação

whasapo uninstall

Ou remotamente:

curl -sSL https://raw.githubusercontent.com/toloco/whasapo/main/install.sh | bash -s -- --uninstall

Compilar a partir do código-fonte

Requer Go 1.23+.

make build          # build for your machine → bin/whasapo
make release        # macOS universal binary → dist/whasapo-VERSION-macos.zip
make release-all    # all platforms → dist/whasapo-VERSION-{macos,linux,windows}.*

Como funciona

O Whasapo é um servidor MCP que se conecta ao WhatsApp usando a biblioteca whatsmeow — o mesmo protocolo usado pelos aplicativos oficiais do WhatsApp.

Sua sessão do WhatsApp é armazenada localmente em ~/.whasapo/session.db. As mensagens são persistidas em SQLite para sobreviverem a reinicializações. Nenhum dado é enviado a servidores de terceiros.