whatsapp-mcp is a small server that runs inside your own Cloudflare account. By linking your phone to it once, it allows AI agents and other Model Context Protocol (MCP) clients to search, read, and summarize your WhatsApp chats.
Who it’s for
People who want to connect their AI assistants, such as Claude Code or Claude Desktop, to their personal WhatsApp chat history.
What it does, according to the maker
- Search and read through all WhatsApp messages and chats
- Perform full-text searches across all history or within specific chats
- Save and remember names for phone numbers
- Automatically sync new messages daily or on demand
How to get started
- Clone the repository using git clone https://github.com/finereli/whatsapp-mcp and navigate into the folder
- Run npm install to install dependencies
- Create a sign-in token namespace and owner password using Wrangler commands
- Deploy the project using npm run deploy and scan the generated QR code with WhatsApp on your phone
Pricing
Open source software, though it requires a Cloudflare Workers Paid plan which costs a few dollars a month.
Availability
Available on GitHub.
Good to know
- Your messages are stored in a SQLite database inside a Durable Object in your own Cloudflare account
- It uses the Baileys library and WhatsApp Web protocol, which runs counter to WhatsApp's terms of service
- Media files like photos and voice notes are not downloaded and appear only as text labels