# WireCat WhatsApp

WireCat WhatsApp — an MCP server that links your WhatsApp account to an agent: read chats, search messages, and send replies through a CLI.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 4 repo stars
- Author: WireCatLabs
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/WireCatLabs/whatsapp-cli
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/wirecat-whatsapp

## What it does

The server installs the `wa` CLI, which pairs with your personal WhatsApp account as a linked device (via QR code, like WhatsApp Web) and exposes commands for reading, searching, and sending messages. An agent can check unread chats, search conversations by keyword, send text to a chat or group, add a reaction, or edit and delete its own messages. Sending is rate-limited: the tool caps outgoing messages (the built-in limit is 30 per hour) and pauses operations if WhatsApp requests a slowdown.

WhatsApp prohibits unofficial clients, and accounts using third-party tools or sending bulk messages to strangers risk being banned. The tool works only with personal profiles, not for mass outreach, and sends messages only on explicit command.

Requires Node.js 22.16+ or 24+. Installation starts with the global package `@wirecat/whatsapp-cli`, then `wa personal setup --agent claude` links the account and installs the agent skill. The command `wa personal mcp add claude-code` adds the MCP server to the config, but sending is disabled by default — run it again with `--allow-writes` to enable.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add whatsapp-cli -- npx -y @wirecat/whatsapp-cli
```

### Codex

**Platform CLI**
```bash
codex mcp add wirecat-whatsapp -- npx -y @wirecat/whatsapp-cli
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "wirecat-whatsapp": {
            "command": "npx",
            "args": [
                "-y",
                "@wirecat/whatsapp-cli"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "wirecat-whatsapp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@wirecat/whatsapp-cli"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add wirecat-whatsapp npx -y @wirecat/whatsapp-cli
```

## When to use it
- check who is waiting for a reply since yesterday
- find a message about the meeting venue in a chat with Alice
- send text to a chat or group on the agent's command
- see who joined a group in the past week
- add a reaction or edit your own message

## Example prompts
- Use `wa`. Who is waiting for my answer since last night?
- Use `wa`. Find when Alice and I discussed the meeting venue.
- Use `wa`. Send to the Book Club chat: 'Call at 3?'

## Similar
- [whatsapp](https://affpapa.org/en/nevibecode/skills/whatsapp.md) — skill · 373 installs
- [integrate-whatsapp](https://affpapa.org/en/nevibecode/skills/integrate-whatsapp.md) — skill · 5400 installs
- [mcp-whatsapp-cloud](https://affpapa.org/en/nevibecode/mcp/mcp-whatsapp-cloud.md) — MCP server · ★ 279 repo stars
- [WACrew · WhatsApp MCP server](https://affpapa.org/en/nevibecode/mcp/wacrew-whatsapp-mcp-server.md) — MCP server · ★ 10 repo stars
- [whatsapp-automation](https://affpapa.org/en/nevibecode/skills/whatsapp-automation.md) — skill · 6700 installs
- [whatsapp-marketing](https://affpapa.org/en/nevibecode/skills/whatsapp-marketing.md) — skill · 2000 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
