whatsapp — MCP server for Claude Code: read and search WhatsApp
Connects your WhatsApp to any MCP client: read, search and optionally send messages through a bearer token, with nothing running locally.
claude mcp add --transport http whatsapp https://wacli.me/mcpWhat whatsapp does
wacli.me is a hosted MCP gateway that sits in front of the wacli CLI. You link an account once by scanning a QR code, the same way WhatsApp Web does it, and get back a URL plus a bearer token. From there an MCP client can read and search messages; sending is a separate switch.
The server speaks Streamable HTTP at /mcp and expects Authorization: Bearer …. Each token in config/tenants.json maps to exactly one store directory, so tenants stay isolated from one another. That file is re-read every 5 seconds, which means a new tenant goes live without a restart. The send_message tool only appears when allowSend is true; keep it false unless the account owner asked for write access.
Reads call wacli with --read-only, so a bad tool call cannot change the store. Skip the sync daemon and the store holds only what the last run pulled. Linking relies on an unofficial WhatsApp client, which breaks WhatsApp's terms of service and can get a number blocked by Meta. Use it on accounts you own.
What it helps with
- find a message without picking up the phone
- pull chat history into an agent session
- send a WhatsApp message from an MCP client
- keep several accounts in separate stores
- self-host a gateway to WhatsApp with no local install
Example prompts for the agent
- Search my WhatsApp for messages from Ivan last week
- Show the latest messages in the team chat
- Send a WhatsApp note: the meeting moved an hour later
How to install whatsapp
Platform CLI: remote server
claude mcp add --transport http whatsapp https://wacli.me/mcpPlatform CLI: remote server
codex mcp add whatsapp --url https://wacli.me/mcpConfig file
{
"mcpServers": {
"whatsapp": {
"url": "https://wacli.me/mcp"
}
}
}Config file
{
"servers": {
"whatsapp": {
"type": "http",
"url": "https://wacli.me/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http whatsapp https://wacli.me/mcpStep 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 whatsapp
How do I install whatsapp in Claude Code?
Run claude mcp add --transport http whatsapp https://wacli.me/mcp, then link your account via the QR on /connect and use the token it issues.
What does whatsapp do?
It gives an MCP client access to your WhatsApp for reading and searching, plus sending when allowSend is on.
Do I need to run anything locally?
No, the gateway is hosted at https://wacli.me. Self-hosting is documented in the Running section.
