whatsapp-mcp

About

Ask your agent what was said in WhatsApp

Ask things like "what did Dana say about the flights?" or "summarize what I missed in the family group this week". The server connects to WhatsApp only when your agent asks and once a day, pulls what was queued, stores it in a Durable Object and hangs up, so your phone keeps working normally. Tools: list_chats, get_messages, search_messages, unnamed_chats, set_contact_names, sync_now, link_status and relink. Chats that show up as phone numbers can be named by your agent using whatever contacts tool it already has. Sign-in is OAuth with an owner password. Caveats from the author: it is unofficial and uses the WhatsApp Web protocol (Baileys), which is against WhatsApp's terms, so the risk is low for a read-only linked device but not zero; media is not downloaded; one deployment is for one person; and the history import needs the Workers Paid plan (a few dollars a month). Made by Eli Finer (@finereli) and shared as a Show HN on Hacker News.

Features

• Read-only: it cannot send messages
• Runs in your own Cloudflare account, data stays there
• Full-text search across every chat
• Agent can name unknown numbers from your contacts
• Syncs on demand and once a day
• OAuth sign-in for Claude Code and other MCP clients

Install