# WACrew

> WACrew is an open-source MCP server for communication. Lets coding agents read, search and reply to WhatsApp chats at a human pace. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** whatsapp, self-hosted, CLI
- **Website:** https://wacrew.com.br
- **Repository:** https://github.com/sumioshi/wacrew/tree/HEAD/packages/mcp
- **MCP Registry name:** io.github.sumioshi/wacrew
- **Categories:** communication, productivity
- **Listing updated:** 2026-11-14

## About

WACrew's MCP package connects an agent to a WACrew panel, the open-source collector that you run yourself and link to WhatsApp by scanning a QR code. From there an agent can list groups, read and search messages, get a daily summary, transcribe voice notes and inspect images, videos and documents.

Sending is deliberately gated. Each chat is either in confirm mode, the default, where the agent shows the text and waits for your OK, or autonomous. Drafts pass a deterministic review that blocks robot-sounding text, and delivery imitates a read receipt, typing indicator and pauses, cancelling itself if the client writes again.

It uses Baileys, the WhatsApp Web multi-device library, not the official API, and the README says to use it only with people who already talk to you, never for bulk messaging. The project is Apache 2.0, with 36 tools and a Portuguese site.

## Features

- **Chat reading and search:** List groups, read messages and search history.
- **Voice note transcription:** Transcribes audio and inspects images, video and PDFs.
- **Confirm-first replies:** Default mode shows the draft and waits for approval.
- **Human-paced delivery:** Read receipt, typing indicator and pauses.
- **Robot-text review:** Deterministic checks block stock phrases and repeats.
- **Self-hosted collector:** You run the panel with Docker.

## Good for

- Triage a queue of client WhatsApp groups
- Summarise the day's conversations
- Transcribe a long voice note
- Draft replies in your own style for approval

## Install

### Claude Code (Terminal)

```sh
claude mcp add wacrew --env WAC_CLOUD_URL='<WAC_CLOUD_URL>' --env WAC_CLOUD_USER='<WAC_CLOUD_USER>' --env WAC_CLOUD_PASS='<WAC_CLOUD_PASS>' -- npx -y wacrew-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "wacrew": {
      "command": "npx",
      "args": [
        "-y",
        "wacrew-mcp"
      ],
      "env": {
        "WAC_CLOUD_URL": "<WAC_CLOUD_URL>",
        "WAC_CLOUD_USER": "<WAC_CLOUD_USER>",
        "WAC_CLOUD_PASS": "<WAC_CLOUD_PASS>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "wacrew": {
      "command": "npx",
      "args": [
        "-y",
        "wacrew-mcp"
      ],
      "env": {
        "WAC_CLOUD_URL": "<WAC_CLOUD_URL>",
        "WAC_CLOUD_USER": "<WAC_CLOUD_USER>",
        "WAC_CLOUD_PASS": "<WAC_CLOUD_PASS>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "wacrew": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "wacrew-mcp"
      ],
      "env": {
        "WAC_CLOUD_URL": "<WAC_CLOUD_URL>",
        "WAC_CLOUD_USER": "<WAC_CLOUD_USER>",
        "WAC_CLOUD_PASS": "<WAC_CLOUD_PASS>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "wacrew": {
      "command": "npx",
      "args": [
        "-y",
        "wacrew-mcp"
      ],
      "env": {
        "WAC_CLOUD_URL": "<WAC_CLOUD_URL>",
        "WAC_CLOUD_USER": "<WAC_CLOUD_USER>",
        "WAC_CLOUD_PASS": "<WAC_CLOUD_PASS>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "wacrew": {
      "command": "npx",
      "args": [
        "-y",
        "wacrew-mcp"
      ],
      "env": {
        "WAC_CLOUD_URL": "<WAC_CLOUD_URL>",
        "WAC_CLOUD_USER": "<WAC_CLOUD_USER>",
        "WAC_CLOUD_PASS": "<WAC_CLOUD_PASS>"
      }
    }
  }
}
```

## Tools

- `listar_grupos`: List WhatsApp groups
- `ler_mensagens`: Read messages
- `buscar`: Search messages
- `resumo_do_dia`: Summarise the day
- `transcrever`: Transcribe voice notes
- `ver_imagem`: Inspect an image
- `assistir_video`: Inspect a video
- `ler_documento`: Read a document
- `preparar_resposta`: Prepare a reply draft
- `revisar_texto`: Review text for robotic phrasing
- `responder`: Send a reply
- `status_envio`: Check delivery status
- `cancelar_envio`: Cancel a pending send

## FAQ

### Does it send messages automatically?

Only if you set a chat to autonomous; the default asks for your approval first.

### Does it use the official WhatsApp API?

No. It uses Baileys; the README warns against bulk messaging.

### What do I need?

A running WACrew panel and its URL, username and password in the environment.

### What licence is it?

Apache 2.0.

### Is WACrew free?

Yes. WACrew is open source, so you can use and self-host it for free.

### How do I add WACrew to Claude Code?

Run this command in your terminal: claude mcp add wacrew --env WAC_CLOUD_URL='<WAC_CLOUD_URL>' --env WAC_CLOUD_USER='<WAC_CLOUD_USER>' --env WAC_CLOUD_PASS='<WAC_CLOUD_PASS>' -- npx -y wacrew-mcp

### What are the best alternatives to WACrew?

The closest alternatives to WACrew are Ha MCP, Concord MCP, note1, BoardAgent and Callout.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.

---
Source: https://ai-powered.com/mcp/wacrew
