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
claude mcp add whatsapp-cli -- npx -y @wirecat/whatsapp-cliWhat 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-cliPlatform CLI
codex mcp add wirecat-whatsapp -- npx -y @wirecat/whatsapp-cliConfig file
{
"mcpServers": {
"wirecat-whatsapp": {
"command": "npx",
"args": [
"-y",
"@wirecat/whatsapp-cli"
]
}
}
}Config file
{
"servers": {
"wirecat-whatsapp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@wirecat/whatsapp-cli"
]
}
}
}Platform CLI
gemini mcp add wirecat-whatsapp npx -y @wirecat/whatsapp-cliStep 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.