Skip to content
MCP server

WireCat WhatsApp

Read, search and send from your own WhatsApp account with local history

Runs locally
Install
Platforms
CLI, macOS, Windows
Runs
Locally
Version
0.45.0
Listing updated
5 days ago

Similar MCP servers

About WireCat WhatsApp

WireCat WhatsApp is an MCP server for communication. It runs locally on your machine and is started by your AI client.

The wa tool links your personal account as a linked device, with you approving a QR code on your phone, and keeps saved chats in a local database for searching. Business-number bots use a separate Cloud API connection.

Writes happen only when a command asks, at most 30 messages an hour by default, and are held when WhatsApp signals to slow down. The README warns that this is an unofficial client: WhatsApp's terms forbid such clients and it may ban an account, and bulk sending or messaging strangers raises that risk.

An example flow lists unanswered chats, drafts a reply, and sends only after confirmation.

Install

Run in a terminal

claude mcp add whatsapp-cli -- npx -y @wirecat/whatsapp-cli

Add to claude_desktop_config.json

{
  "mcpServers": {
    "whatsapp-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@wirecat/whatsapp-cli"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "whatsapp-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@wirecat/whatsapp-cli"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "whatsapp-cli": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@wirecat/whatsapp-cli"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "whatsapp-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@wirecat/whatsapp-cli"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "whatsapp-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@wirecat/whatsapp-cli"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

What it does

Linked-device sign-in
Approve a QR code on your phone.
Local searchable history
Chats are searchable on your computer.
Rate-limited sending
30 messages an hour by default.
Draft then confirm
Agents propose replies for approval.
Group review
Check members before admin actions.

Good for

  • Find chats awaiting your reply
  • Search an old agreement
  • Draft and send a reply with approval
  • Review group members

More servers for the same service

WireCat WhatsApp FAQ

Is it official?

No, it is unofficial and may risk a ban.

Can it bulk send?

No, avoid it; there is a default hourly limit.

What does MCP need?

Sign in with the wa CLI first.

How do I add WireCat WhatsApp to Claude Code?

Run this command in your terminal: claude mcp add whatsapp-cli -- npx -y @wirecat/whatsapp-cli

What are the best alternatives to WireCat WhatsApp?

The closest alternatives to WireCat WhatsApp are Wazap, WireCat Telegram, askmywa for WhatsApp, Whatsapp Tools and Wapliss WhatsApp.

Where this comes from

  • Description: written from the project's README and the project's website.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers