WAHA MCP Server

Servidor MCP para envio de mensagens no WhatsApp utilizando WaHa.

Pré-requisitos

• Docker (para rodar o WaHa)
• WaHa rodando localmente
• MCP Client para testar (Cursor, Claude Desktop, MCP Inspector)

Docker para Mac (Apple Silicon - ARM/M1/M2)

Se você está usando um Mac com processador ARM (Apple Silicon, M1/M2), utilize a imagem específica para ARM:

docker pull devlikeapro/waha:arm
docker tag devlikeapro/waha:arm devlikeapro/waha

Depois, rode normalmente o container (veja o próximo passo).

Para mais detalhes, consulte a documentação oficial do WaHa.

1. Suba o WaHa

docker run -it --rm -p 3000:3000/tcp --name waha devlikeapro/waha

• Abra o dashboard: http://localhost:3000/dashboard
• Inicie a sessão padrão (default) e faça a autenticação via QR Code com seu WhatsApp.

2. Instale as dependências do projeto

Crie um ambiente virtual (opcional, mas recomendado):

python -m venv .venv
source .venv/bin/activate  # Linux/macOS
.venv\Scripts\activate    # Windows

Instale as dependências:

pip install "mcp[cli]" httpx

3. Configure os contatos

Crie e edite o arquivo contatos.txt na raiz do projeto com os contatos desejados, um por linha, no formato:

Nome;556299999999@c.us

Exemplo:

Jonas;556299999999@c.us
Alexandre;556299999998@c.us
Alex;556299999997@c.us

4. Adicionar tool ao Claude Desktop

Passo a passo para integrar mcp server do WAHA no Claude Desktop

1. Abra o menu Claude no topo da tela e selecione Settings...

   !Passo 1

2. No menu lateral esquerdo, clique em Developer.

3. Clique em Edit Config no canto inferior esquerdo.

   !Passo 2

4. Abra o arquivo claude_desktop_config.json e localize (ou crie) a seção mcpServers.

   !Passo 3

5. Adicione (ou edite) a configuração do servidor WAHA conforme abaixo:

{
  "mcpServers": {
    "waha": {
      "command": "/Users/andre/.local/bin/uv",
      "args": [
        "--directory",
        "/Users/andre/dev/tsia/waha-mcp",
        "run",
        "waha.py"
      ]
    }
  }
}

• Certifique-se de ajustar os caminhos conforme o seu ambiente, se necessário.

6. Salve o arquivo e reinicie o Claude Desktop.

5. Teste no Claude Desktop ou MCP Inspector

Abaixo, um passo a passo visual do fluxo de uso no Claude Desktop:

5.1. Visualize os servidores MCP disponíveis

!MCP Servers

5.2. Veja a ferramenta (tool) disponível no servidor WAHA

!Ferramenta send_message

5.3. Adicione contatos acessando o resource

!Adicionar contatos pelo resource

!Contatos fornecidos

5.4. Peca que seja enviado uma mensagem para o contato

!Conversando com Claude

5.5. Permita a execução do comando (se solicitado pelo sistema)

!Permissão de execução

5.6. Veja o resultado final da conversa com o Claude

!Resultado final

!Mensagem enviada

Observações

• O WaHa deve estar rodando e autenticado para o envio funcionar.
• O número deve ser passado sem o sinal de + e terminar com @c.us.
• Você pode editar o arquivo contatos.txt a qualquer momento.

Referências

• WaHa Quick Start
• MCP Python SDK