whatsapp-mcp
Lets AI agents search your WhatsApp messages
Developer ToolsOpen sourceOpen source · verified#mcp#whatsapp#ai-agents
Listed by the ProductPerch team from Hacker News · not launched here yet
What is whatsapp-mcp?
whatsapp-mcp is a read-only Model Context Protocol server that allows AI agents to search and read personal WhatsApp messages. It runs on Cloudflare Workers and stores message history in a local SQLite database within a Cloudflare Durable Object. The tool connects to your phone once using the same protocol as WhatsApp Web, then periodically syncs queued messages without keeping a constant connection.
Setup requires a Cloudflare account on the Workers paid plan, Node 20 or later, and a smartphone. After cloning the repository and running installation commands, users deploy the server and link their device by scanning a QR code. Once connected, any MCP-compatible client like Claude Code or Claude Desktop can query the chat history. The server cannot send messages and operates strictly as a read-only bridge between WhatsApp and AI tools.
whatsapp-mcp features
- Read-only access to personal WhatsApp message history
- Runs on Cloudflare Workers with local SQLite storage
- Compatible with any MCP client like Claude Code or Claude Desktop
- Syncs messages periodically without maintaining a constant connection
- Allows custom naming for phone numbers during searches
- Self-hosted deployment with simple terminal commands
Who uses whatsapp-mcp and for what
- Search across all chats for mentions of specific topics like leases or flights
- Summarize missed conversations from family or group chats over a set period
- Retrieve past contact details or agreements shared via WhatsApp
- Integrate personal messaging history into AI coding or research workflows
- Track important dates or reminders sent through private messages
whatsapp-mcp FAQ
Is whatsapp-mcp free?
The software is released under an MIT license and is free to download and modify. However, running it requires a Cloudflare Workers paid plan, which costs a few dollars per month. The website does not say if there are other hidden costs.
Is whatsapp-mcp open source?
Yes, the repository is public and licensed under the MIT license. The source code is available for review and modification on GitHub.
What is whatsapp-mcp used for?
It is used to let AI agents search and read personal WhatsApp messages. It acts as a read-only bridge that syncs message history to a local database so compatible clients can query chat logs.
Does whatsapp-mcp work on Mac?
The website does not specify operating system requirements for the host machine, but it requires Node 20 or later and a Cloudflare account to deploy the server.
Can whatsapp-mcp send WhatsApp messages?
No, the tool is strictly read-only. It cannot send messages or interact with contacts beyond reading and searching existing chat history.
Comments (0)
Comments and upvotes open when this product launches on ProductPerch.
More Developer Tools launches
Monitor Laravel scheduled tasks and queues
Free product launch platform for indie makers
PloyzOpen source
The open-source cloud on servers you rent
