whatsapp-mcp
3,854
This project is a Model Context Protocol server for WhatsApp that allows users to search, read, and send messages and media through Claude, with all data securely stored in a local SQLite database. It directly connects to a personal WhatsApp account via the web API.
WhatsApp MCP Server
This project provides a Model Context Protocol (MCP) server for WhatsApp, enabling users to manage and interact with their WhatsApp messages through Claude. Features include:
- Searching and reading personal WhatsApp messages, including media.
- Sending messages and media files to individuals or groups.
- Integration with the WhatsApp web API using the
whatsmeow
library. - Local storage of messages in a SQLite database.
Installation
- Requires Go, Python 3.6+, Anthropic Claude Desktop app, and UV.
- Optional FFmpeg for audio messages.
Usage
Once set up, users can search contacts, retrieve messages and chats, and send messages and media.
Architecture Overview
- Go WhatsApp Bridge: Handles WhatsApp API connections and stores messages in SQLite.
- Python MCP Server: Provides tools for Claude to interact with WhatsApp data.