whatsapp-mcp
If you are the rightful owner of whatsapp-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
This is a Model Context Protocol (MCP) server for WhatsApp, allowing interaction with personal WhatsApp messages and contacts.
The WhatsApp MCP Server is designed to facilitate interaction with personal WhatsApp accounts through the WhatsApp web multidevice API. It allows users to search and read messages, send messages and media files, and manage contacts. The server connects directly to a personal WhatsApp account using the whatsmeow library, storing messages locally in a SQLite database. This setup ensures that messages are only sent to an LLM when accessed through controlled tools. The server is implemented using a Go application for the WhatsApp bridge and a Python server for the MCP protocol, providing a seamless integration with platforms like Claude and Cursor.
Features
- Direct connection to personal WhatsApp account via WhatsApp web multidevice API.
- Local storage of messages in a SQLite database for privacy and control.
- Capability to send and receive various media types including images, videos, and audio messages.
- Integration with LLMs like Claude for enhanced interaction with WhatsApp data.
- Support for media conversion using FFmpeg for optimal compatibility.
Tools
search_contacts
Search for contacts by name or phone number
list_messages
Retrieve messages with optional filters and context
list_chats
List available chat history and its metadata
get_chat
Get information for specific chats
get_direct_chat_by_contact
Find direct chats with specific contacts
get_contact_chats
List all chats involving a specific contact
get_last_interaction
Get the latest news with contacts
get_message_context
Retrieve the context of a specific message
send_message
Send WhatsApp messages to the specified phone number or group JID
send_file
Send files (pictures, videos, original audio, document) to the designated recipients
send_audio_message
Send audio files as WhatsApp voice messages (requires the file in .ogg opus format or install ffmpeg)
download_media
Download media from WhatsApp messages and get local file path