finereli/whatsapp-mcp
A read-only MCP server that lets your AI agent search and read your own WhatsApp messages. Use it free at whatsapp.finereli.com, or run your own copy on Cloudflare.
Older snapshot: check the original source for current information.
From the publisher
README & documentation
Source previewRead the project’s overview, installation instructions and usage examples. The original README is the source of truth.
Connect ChatGPT, Claude or Grok to your WhatsApp. It is a read-only MCP server over your own message history, stored encrypted, and open source. You link your phone once, the way you'd link WhatsApp Web, and from then on any MCP client can search and read your chats. It can't send anything. Built by @finereli. Questions and bug reports go in an issue here, or to me on X. There are two ways to use it: The easiest way to set up the hosted version is to let your agent do it. Paste this into Claude, ChatGPT or Grok: Ask your agent things like: Your phone stays the source of truth. The server is a linked device that your agent talks to. It doesn't stay connected to WhatsApp. When your agent asks for something, it connects, collects whatever WhatsApp queued for it since last time, writes that to its own…
Read the full README ↗ · Preview checked 2026-10-31T00:45:05.940Z
Inside the original README — Document outline
- whatsapp-mcp
- How it works
- What it guarantees, and what it doesn't
- Run your own copy
- The Workers Paid note
- Upgrading from an earlier version
- Things to know
- Running it for other people
- Caps, and getting told when you hit them
- What your agent can do
- Naming chats
- For agents, and people adapting this
Headings are captured from the source. Links open the publisher’s document, not a locally hosted copy.
Documentation belongs to its respective authors. Reported project/model license: MIT. A listing is not a grant of reuse or training rights. Confirm the document’s own terms at the source.
What this repository does
A read-only MCP server that lets your AI agent search and read your own WhatsApp messages. Use it free at whatsapp.finereli.com, or run your own copy on Cloudflare.
Repository facts
- Owner
- finereli
- Primary language
- TypeScript
- Stars
- 370
- Forks
- 31
- Open issues + pull requests
- 1
- License
- MIT
- Archived
- No
- Default branch
- main
- Created
- 2026-10-18T21:01:54.000Z
- Last push
- 2026-10-24T13:31:54.000Z
Topics and intended use
No topics were included in the latest source metadata.
Review the README for scope, installation, examples and limitations. We do not run repository code or certify it.
Evaluate before installing
Review licensing and dependencies, inspect recent commits and unresolved issues, and test in an isolated environment before production use. Stars and forks alone cannot answer these questions.
Source and freshness
Source: GitHub. Metadata observed 2026-10-25T12:13:46.029Z. Daily imports are snapshots, not real-time monitoring.
Popularity and source listings do not establish security, suitability, licensing rights or benchmark performance.