whatsapp-mcp empowers you to interact with your WhatsApp messages and contacts using large language models like Claude. It leverages the Model Context Protocol (MCP) to establish a standardized interface between WhatsApp and AI agents. The core functionality involves bridging WhatsApp's web API with a Python MCP server, allowing Claude to access your data and send messages.
This project distinguishes itself through its direct integration with WhatsApp's web API via the whatsmeow library, providing a comprehensive and flexible way to access message history, contacts, and media. The use of SQLite for local storage ensures data privacy and efficient retrieval. The flexible architecture permits easy integration with various LLMs beyond Claude.
- Message Retrieval: Search and read personal WhatsApp messages (text, images, videos, documents, audio).
- Contact Management: Search and retrieve WhatsApp contacts by name or phone number.
- Message Sending: Send text messages, images, videos, documents, and audio messages to both individuals and groups.
- Media Handling: Support for sending and downloading various media file types, with automatic audio format conversion.
- Extensible Tools: Provides a set of tools like
search_contacts,list_messages, andsend_messagefor interacting with WhatsApp data. - Claude Integration: Seamlessly integrates with Claude for AI-powered WhatsApp interactions.
- SQLite Storage: Locally stores message history for efficient access and privacy.
The project is actively maintained with recent commits and ongoing development. Documentation is available, although further expansion would enhance usability. Community support is growing. The project's reliance on the WhatsApp Web API and the Model Context Protocol suggests a relatively stable and evolving ecosystem.
whatsapp-mcp benefits individuals who want to leverage AI to manage their WhatsApp communications, automate tasks, or use WhatsApp as input for AI workflows. It addresses the limitations of manual WhatsApp usage by providing a powerful and convenient interface for interacting with messages and contacts. It's a valuable tool for those seeking advanced capabilities beyond standard messaging apps.