whatsapp-mcp
WhatsApp MCP server
The WhatsApp MCP server enables AI assistants to interact with your personal WhatsApp account through the Model Context Protocol. It connects directly to WhatsApp Web's multidevice API, storing message history locally in SQLite and providing tools to search contacts, read messages (including media), and send text or media files to individuals and groups. Built with a Go bridge for WhatsApp connectivity and a Python MCP server layer, it gives Claude and other MCP clients full access to your WhatsApp conversations while keeping all data stored locally on your machine.
Key Features
Use Cases
- 01Automate WhatsApp message responses using Claude's natural language understanding
- 02Search through WhatsApp conversation history to find specific messages or contacts
- 03Send automated WhatsApp messages or media files to individuals or groups through AI prompts
- 04Analyze WhatsApp conversation patterns and retrieve contextual chat history
- 05Download and process media attachments from WhatsApp messages for further AI analysis
- 06Integrate WhatsApp communication into AI-powered workflows and agent tasks
Related MCP Servers
View moremarkitdown
Python tool for converting files and office documents to Markdown.
firecrawl
The context API to search, scrape, and interact with the web at scale. 🔥
prompts.chat
f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete privacy.
langflow
Langflow is a powerful tool for building and deploying AI-powered agents and workflows.
whatsapp-mcp — FAQ
What is the WhatsApp MCP server?+
It's a Model Context Protocol server that connects AI assistants like Claude to your personal WhatsApp account, allowing them to read messages, search contacts, and send text or media files. All messages are stored locally in SQLite and only accessed when you authorize the AI to use specific tools.
How do I install the WhatsApp MCP server?+
Clone the repository, run the Go bridge application (which prompts a QR code for WhatsApp authentication), then add the MCP server configuration to your Claude Desktop or Cursor settings file. You'll need Go, Python 3.6+, and UV package manager installed as prerequisites.
Which AI clients work with this MCP server?+
It works with Claude Desktop and Cursor. Any MCP-compatible client can theoretically use it, but the setup instructions focus on these two applications.
Do I need API keys or special permissions?+
No API keys are required. You authenticate by scanning a QR code with your WhatsApp mobile app, similar to linking WhatsApp Web. Re-authentication may be needed after approximately 20 days.
Is this WhatsApp MCP server free to use?+
Yes, it's open source and free. However, be aware of potential security risks from prompt injection that could lead to data exfiltration, as noted in the documentation.
What are the prerequisites for installation?+
You need Go, Python 3.6+, UV package manager, and either Claude Desktop or Cursor installed. FFmpeg is optional but recommended for sending audio files as playable voice messages. Windows users also need a C compiler with CGO enabled.
How do I install whatsapp-mcp?+
Open the source repository on GitHub and follow its README. whatsapp-mcp is a mcp server — MCP Agents Market links you directly to the official repo.
Is whatsapp-mcp free?+
whatsapp-mcp is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.