WACrew

Guide

WhatsApp MCP in Claude Desktop: the config file, step by step

Add a WhatsApp MCP server to Claude Desktop through claude_desktop_config.json on macOS and Windows, check the tools load, and ask Claude about your groups and chats.

Updated 2 min read
On this page
  1. What you need
  2. Edit claude_desktop_config.json
  3. What to ask
  4. Sending stays careful
  5. If the tools do not appear
  6. FAQ

Claude Desktop is the friendliest place to try a Claude MCP server for WhatsApp: no terminal session to keep open, and Claude can summarize a group or draft a reply in a normal chat window. The setup is one JSON file. This guide uses WACrew's open-source server, wacrew-mcp.

What you need

  • A WACrew collector holding your WhatsApp session, on a VPS or Railway, with HTTPS in front of the panel. The connection guide covers it in two commands.
  • Node 20 or newer on the computer that runs Claude Desktop, because the server starts with npx.

Edit claude_desktop_config.json

In Claude Desktop open Settings, Developer, Edit Config. It opens the file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the server inside mcpServers (keep any servers already there):

{
  "mcpServers": {
    "wacrew": {
      "command": "npx",
      "args": ["-y", "wacrew-mcp"],
      "env": {
        "WAC_CLOUD_URL": "https://your-panel.example.com",
        "WAC_CLOUD_USER": "admin",
        "WAC_CLOUD_PASS": "change-me"
      }
    }
  }
}

Quit Claude Desktop completely and open it again. The server shows up in the tools menu of the chat box with 37 tools.

What to ask

  • "Who is waiting for a reply on WhatsApp?" (caixa_de_entrada)
  • "Summarize today in the Acme project group." (resumo_do_dia)
  • "Transcribe the last voice note from Ana." (transcrever)
  • "Draft a reply to the last message in that group and show me before sending." (preparar_resposta, then responder after your OK)

Claude asks permission before calling a tool unless you allow it for the chat. Keep that on for sending tools at first.

Sending stays careful

Each chat starts in confirm mode, so the instructions tell Claude to show the text first. responder runs a review that refuses robotic text (wrong form of address, admissions of fault, repeated openings) and returns a ticket: the message leaves later, at a human pace, and cancelar_envio stops it.

If the tools do not appear

Open Settings, Developer: Claude Desktop shows the server status and a log link. The usual causes are invalid JSON (a missing comma), Node not found in the PATH Claude Desktop sees, or a wrong panel URL or password. More in troubleshooting.

FAQ

Does Claude Desktop keep WhatsApp connected? No, the collector does. Claude Desktop only starts the MCP server when it runs, and the server reads from the collector.

Can I use the same server in Claude Code too? Yes. Claude Code uses claude mcp add, with the same variables; see the Claude Code guide.

Will Claude send messages on its own? Not in confirm mode, which is the default. Even in auto mode every send passes the review and can be cancelled.

Is my WhatsApp data sent to Anthropic? Only what the tools return in the conversation you are having, as with any MCP server. The history itself stays in your collector.