Whatsapp MCP

WhatsApp MCP + CLI

Uma integração do WhatsApp que funciona de duas maneiras:

• Servidor MCP — permite que assistentes de IA como o Claude controlem o WhatsApp diretamente
• Ferramenta CLI — envie/leia mensagens do WhatsApp a partir do seu terminal

Construído sobre whatsapp-web.js.

---

Recursos

• Envie mensagens do WhatsApp por nome do contato ou número de telefone
• Leia mensagens recentes de qualquer conversa
• Liste todas as conversas recentes com pré-visualizações
• Pesquise contatos por nome
• Funciona como servidor MCP (Claude, etc.) ou CLI autônomo

---

Configuração

1. Instale as dependências

npm install

2. Autentique o WhatsApp

node index.js auth

Escaneie o código QR com o aplicativo móvel do WhatsApp. Sua sessão é salva localmente — você só precisa fazer isso uma vez.

---

Servidor MCP (para Claude / assistentes de IA)

O servidor MCP expõe 4 ferramentas via stdio:

Ferramenta	Descrição
send_message	Envie uma mensagem para um contato
read_messages	Leia mensagens recentes de uma conversa
list_chats	Liste conversas recentes com pré-visualizações
search_contacts	Pesquise contatos por nome

Configure no Claude Code

Adicione ao seu .mcp.json ou às configurações MCP do Claude Code:

{
  "mcpServers": {
    "whatsapp": {
      "command": "node",
      "args": ["C:/path/to/whatsapp-cli/mcp-server.mjs"]
    }
  }
}

Execute manualmente

node mcp-server.mjs

---

Uso da CLI

Envie uma mensagem

node index.js send --to "John Doe" --message "Hey!"
# or by phone number
node index.js send --to 919876543210 --message "Hey!"

Leia mensagens

node index.js read --from "John Doe" --count 20

Liste conversas

node index.js list-chats --count 10

---

Casos de Uso

• Assistente de WhatsApp com IA — conecte-se ao Claude ou a qualquer IA compatível com MCP para ler e enviar mensagens sem usar as mãos
• Automação do WhatsApp — crie bots, respondedores automáticos ou sistemas de notificação
• Mensagens pelo terminal — envie/leia mensagens do WhatsApp sem abrir o celular
• Notificações de negócios — envie alertas automáticos do WhatsApp a partir de scripts ou tarefas cron

---

Estrutura do Projeto

├── index.js              # CLI entry point
├── mcp-server.mjs        # MCP server (for AI assistants)
├── src/
│   ├── client.js         # WhatsApp client setup
│   └── commands/
│       ├── auth.js       # QR code authentication
│       ├── send.js       # Send message command
│       ├── read.js       # Read messages command
│       └── list-chats.js # List chats command
└── package.json

---

Requisitos

• Node.js 18+
• Uma conta do WhatsApp (pessoal ou empresarial)

---

Licença

MIT