Veriwire
← Back to the wire

GitHub - finereli/whatsapp-mcp: A read-only MCP server that lets your AI agent search and read your own WhatsApp messages. Runs on Cloudflare Workers.

AnnouncementProductOct 18, 2026

An open-source MCP server hosted on GitHub lets AI agents such as Claude Code and Claude Desktop search and read WhatsApp messages. The server runs in the user's own Cloudflare account, storing messages in a SQLite database inside a Durable Object. It is read-only and cannot send messages. It uses WhatsApp's Web protocol via the Baileys library, which violates WhatsApp's terms of service. A Cloudflare Workers Paid plan is required.

Why it matters

An open-source MCP server hosted on GitHub lets AI agents such as Claude Code and Claude Desktop search and read a user's WhatsApp messages. The server runs in the user's own Cloudflare account, linking to the phone like WhatsApp Web and storing messages in a SQLite database inside a Durable Object, so nothing goes elsewhere. It is read-only and cannot send messages. The design is deliberately intermittent: it connects to WhatsApp only when the agent asks or during a daily sync, collects queued messages, then disconnects, leaving the phone working normally. The project requires a Cloudflare Workers Paid plan because importing a large history exceeds the default CPU limit. Notably, WhatsApp offers no official API for reading personal messages, so the server uses the same protocol as WhatsApp Web through the open-source Baileys library, which violates WhatsApp's terms of service. The author acknowledges the practical risk for a read-only linked device is low but not zero. The setup serves one person per deployment, since each holds a full message history and a live login.

Receipt № 24711 source · awaiting confirmation ◐

Evidence

1source· awaiting independent confirmation

No score is assigned. Sources and their independence are shown in the citation chain below.

Citation chain · 1 source

01high
github.comOfficialhttps://github.com/finereli/whatsapp-mcpThis source is the project's own documentation, explaining its read-only design, intermittent connection behavior, self-hosted storage, and its admission that the Baileys-based approach breaks WhatsApp's terms.
PRIMARY
GitHubCompanyClaude CodeModelWhatsAppCompanyCloudflareCompanyClaude DesktopModel

Related

Oct 17OpenAI is building a humanoid robot, but the body isn't the real challenge - EngadgetOct 17Does code quality still matter when AI writes the code?Oct 17Websites are closing their doors to AI agents
Canonical: https://github.com/finereli/whatsapp-mcp