waha-mcp

andrecaraiba/waha-mcp

3.2

If you are the rightful owner of waha-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The WAHA MCP Server facilitates message sending on WhatsApp using the WaHa platform, leveraging Docker and MCP technology.

Tools
1
Resources
0
Prompts
0

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

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.
  1. 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