# WireCat WhatsApp

> WireCat WhatsApp is an MCP server for communication. Read, search and send from your own WhatsApp account with local history. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI, macOS, Windows, Linux
- **Website:** https://wirecat.dev/en/docs/wa
- **Repository:** https://github.com/wirecatlabs/whatsapp-cli
- **MCP Registry name:** dev.wirecat/whatsapp-cli
- **Categories:** [communication](https://ai-powered.com/categories/communication)
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

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

## Alternatives

- [Wazap](https://ai-powered.com/mcp/wazap): Wazap is an open-source MCP server for communication.
- [WireCat Telegram](https://ai-powered.com/mcp/wirecat-telegram): WireCat Telegram is an MCP server for communication.
- [askmywa for WhatsApp](https://ai-powered.com/mcp/askmywa-for-whatsapp): askmywa for WhatsApp is an open-source MCP server for communication.
- [Whatsapp Tools](https://ai-powered.com/mcp/whatsapp-tools): Whatsapp Tools is an open-source MCP server for communication.
- [Wapliss WhatsApp](https://ai-powered.com/mcp/wapliss-whatsapp): Wapliss WhatsApp is a freemium MCP server for communication.
- [WACrew](https://ai-powered.com/mcp/wacrew): WACrew is an open-source MCP server for communication.
- [WaBot](https://ai-powered.com/mcp/wabot): WaBot is an MCP server for communication.
- [whatsapi.sh](https://ai-powered.com/mcp/whatsapi-sh): whatsapi.sh is an MCP server for communication.

---
Source: https://ai-powered.com/mcp/wirecat-whatsapp
