What is WhatsApp MCP Server?
WhatsApp MCP Server is a Model Context Protocol server that connects your personal WhatsApp account to LLM clients like Claude, enabling reading/searching messages, managing contacts, and sending messages or media. It uses the WhatsApp web multidevice API via the whatsmeow library and stores all message history locally in a SQLite database.
How to use WhatsApp MCP Server?
Install Go, Python 3.6+, UV, and optionally FFmpeg. Clone the repository, run the Go WhatsApp bridge (go run main.go), scan the QR code for authentication, then configure the MCP client (Claude Desktop or Cursor) using the provided JSON with paths to UV and the Python server. Restart the client to see the integration.
Key features of WhatsApp MCP Server
- Search contacts by name or phone number
- List and filter messages with context
- View all chats with metadata
- Send text messages to individuals or groups
- Send media files (images, videos, documents, audio)
- Send audio files as WhatsApp voice messages (requires FFmpeg for conversion)
- Download media from messages to local file path
Use cases of WhatsApp MCP Server
- Retrieve and analyse old WhatsApp messages through an LLM
- Automate sending personalised messages to contacts
- Search chat history for specific information
- Send media files programmatically via AI instructions
- Manage WhatsApp conversations from within Claude Desktop
评论