WireCat WhatsApp
Read, search and send from your own WhatsApp account with local history
- 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-cliAdd to claude_desktop_config.json
{
"mcpServers": {
"whatsapp-cli": {
"command": "npx",
"args": [
"-y",
"@wirecat/whatsapp-cli"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"whatsapp-cli": {
"command": "npx",
"args": [
"-y",
"@wirecat/whatsapp-cli"
]
}
}
}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.