whatsapp-mcp: A Model Context Protocol server for interacting with a personal WhatsApp account through supported tools.
What problem it solves
The server lets an MCP-compatible assistant search and read personal WhatsApp messages, contacts, chats, and message context. It also supports sending messages and media files to individuals or groups while keeping message history in a local SQLite database.
Key features
WhatsApp message and contact search — The MCP tools support searching contacts by name or phone number, listing chats and messages, retrieving chat details, and finding recent interactions or context around specific messages.
Source: README
Message and media sending — The server can send text messages and files to phone numbers or group JIDs, including images, videos, documents, and audio messages.
Source: README
Incoming media download — Media metadata is stored locally by default, and the download_media tool can retrieve media from a WhatsApp message and return its local file path.
Source: README
Local SQLite message storage — The Go bridge stores message history and maintains chat and message tables in SQLite, with messages indexed for searching and retrieval.
Source: README
Bridge and MCP architecture — The project separates WhatsApp connectivity and authentication from the MCP interface through a Go bridge and a Python server.
Source: README
Quick start
Copied verbatim from the project's README.
cd whatsapp-bridge
go run main.go {
"mcpServers": {
"whatsapp": {
"command": "{{PATH_TO_UV}}", // Run `which uv` and place the output here
"args": [
"--directory",
"{{PATH_TO_SRC}}/whatsapp-mcp/whatsapp-mcp-server", // cd into the repo, run `pwd` and enter the output here + "/whatsapp-mcp-server"
"run",
"main.py"
]
}
}
}Who it may suit
This project may suit people who want an MCP-compatible assistant to work with their personal WhatsApp messages, contacts, chats, and media through Claude Desktop or Cursor. It may also suit developers interested in connecting a Go WhatsApp bridge to a Python MCP server.
Topics to discuss
How should users configure controlled access to private WhatsApp data and media?
Which additional message, contact, and group-management tools would be useful in community use?
What security and authentication practices should users adopt when running a personal WhatsApp integration?
Written by ReadmeX AI from the project's README, source and public GitHub data; it may contain mistakes.
Read the original README https://github.com/lharries/whatsapp-mcp#readme
ReadmeX opened this community for a trending project; it is not run by the project. Maintainers can claim it from the community page.
Comments
…