whatsapp-mcp
A read-only remote MCP server over your own WhatsApp message history.
What it does
A read-only remote MCP server over your own WhatsApp message history. It links to your account once as a WhatsApp Web device through Baileys, an open-source library, then reconnects only when your agent asks for something, stores new messages in an encrypted SQLite database on Cloudflare, and lets any MCP client search and read chats. It has no tools to send, edit or delete. You can use the author's hosted beta at whatsapp.finereli.com with Google sign-in, or deploy your own copy to Cloudflare Workers with a password-derived key. The README says WhatsApp's terms discourage this kind of access and an account could be restricted.
Capabilities
- Search WhatsApp messages across all chats
- Read chat history from an MCP client
- Keep an encrypted copy of message history
About
- Publisher
- finereli
- Tool
Works with
Install
- Run this to add it to Claude Code:
claude mcp add --transport http whatsapp https://your-url/mcp
From the project's documentation · Add to a config file with the config builder
MCP servers and skills can run code on your computer and act on your data. Review the source before installing.
Details
| Fact | Value | Source |
|---|---|---|
| Type | MCP server | |
| Tool | ||
| Publisher | finereli | source |
| Official status | Community (not published by the tool's vendor) | source |
| Status | beta | source |
| Connection | Remote (hosted, you connect over the internet) | source |
| Can change data | No | source |
| Needs an API key or sign-in | Yes | source |
| Platforms | Not stated in its documentation | |
| AI clients | Claude Code, ChatGPT | source |
| Licence | MIT | source |
| Pricing | Free | source |
| Activity | Last commit Nov 10, 2026413 GitHub starsDownload data not available (not on npm or PyPI) | source |
| Links | Repository Website |
Badge for your README
Maintain this project? Add a badge that links to this page.
[](https://kitbay.app/servers/finereli-whatsapp-mcp/)
Sources
- README (README.md)github.com/finereli/whatsapp-mcp · Backs: AI clients, Can change data, Connection, Needs an API key or sign-in, Official status, Pricing, Publisher, StatusNov 12, 2026
- Licence file (LICENSE)github.com/finereli/whatsapp-mcp · Backs: LicenceNov 12, 2026
- GitHub repositorygithub.com/finereli/whatsapp-mcp · Backs: Activity, LicenceNov 11, 2026
- GitHub API recordgithub.com/finereli/whatsapp-mcpNov 10, 2026