Create

Sign in to ReadmeX

or

How we handle your data: Privacy Policy

ReadmeX

Your AI reading companion

What would you like to catch up on?

Pick a briefing, or ask your own question.

Your community and people briefings stay personal to you.

whatsapp-mcp

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.

github.comhttps://github.com/lharries/whatsapp-mcp

Comments

…