Skip to main content
MCP server CX Codex

WireCat WhatsApp — Claude Code MCP server: what it does

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

Apache-2.0 ★ 4 updated 2026-10-29

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add whatsapp-cli -- npx -y @wirecat/whatsapp-cli
Open on GitHub

What WireCat WhatsApp 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.

What it helps with

  • 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 for the agent

  • 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?'

How to install WireCat WhatsApp

Platform CLI

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

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about WireCat WhatsApp

How do I install WireCat WhatsApp in Claude Code?

Run claude mcp add whatsapp-cli -- npx -y @wirecat/whatsapp-cli, then claude mcp add wirecat-whatsapp -- npx -y @wirecat/whatsapp-cli.

What does WireCat WhatsApp do?

It links a personal WhatsApp account to an agent as a device. The agent can read chats, search messages, send text to a chat or group, add reactions, and edit its own messages. Sending is rate-limited by the hour.

Can I use WireCat WhatsApp for bulk messaging?

No. The tool enforces a sending limit (30 messages per hour by default) and warns that WhatsApp bans accounts for bulk messaging and contacting strangers.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open