whatsapp-mcp
A local MCP server that connects to your personal WhatsApp account as a linked device through the WhatsApp Web multi-device protocol, using the unofficial whatsmeow library.
What it does
A local MCP server that connects to your personal WhatsApp account as a linked device through the WhatsApp Web multi-device protocol, using the unofficial whatsmeow library. A Go bridge logs in by QR code and keeps your messages in a local SQLite database, and a Python MCP server lets Claude Desktop or Cursor read from it. Tools search contacts, list chats and messages with surrounding context, send text, files and voice messages to people or groups, and download media. The README notes re-authentication may be needed after about 20 days and warns about prompt injection leading to data leaks. It needs Go, Python and uv.
Capabilities
- Search and read personal WhatsApp messages
- Search contacts and list chats
- Send messages and files to people or groups
- Send voice messages and download media
About
- Publisher
- lharries
- Tool
Works with
Install
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 | lharries | source |
| Official status | Community (not published by the tool's vendor) | source |
| Connection | Local (runs on your computer) | source |
| Can change data | Yes | source |
| Needs an API key or sign-in | Yes | source |
| Platforms | Not stated in its documentation | |
| AI clients | Claude Desktop, Cursor | source |
| Licence | MIT | source |
| Pricing | Not stated in its documentation | |
| Activity | Last commit Jul 13, 20256,857 GitHub starsDownload data not available (not on npm or PyPI) | source |
| Links | Repository Website |
Sources
- README (README.md)github.com/lharries/whatsapp-mcp · Backs: AI clients, Can change data, Connection, Needs an API key or sign-in, Official status, PublisherNov 12, 2026
- Licence file (LICENSE)github.com/lharries/whatsapp-mcp · Backs: LicenceNov 12, 2026
- GitHub repositorygithub.com/lharries/whatsapp-mcp · Backs: Activity, LicenceNov 11, 2026
- GitHub API recordgithub.com/lharries/whatsapp-mcpNov 10, 2026