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 users to interact with their WhatsApp messages and contacts through an LLM like Claude.
The WhatsApp MCP Server is designed to facilitate seamless interaction with WhatsApp through a Model Context Protocol server. It allows users to search and read personal WhatsApp messages, including media files, and send messages to individuals or groups. The server connects directly to a personal WhatsApp account via the WhatsApp web multidevice API using the whatsmeow library. Messages are stored locally in a SQLite database and are only sent to an LLM when accessed through controlled tools. The server supports sending and receiving various media types and integrates with platforms like Claude and Cursor for enhanced AI-driven communication.
Features
- Direct connection to personal WhatsApp account via WhatsApp web multidevice API.
- Local storage of messages in a SQLite database with controlled access to LLM.
- Support for sending and receiving media files including images, videos, documents, and audio messages.
- Integration with Claude and Cursor for AI-driven communication.
- Automatic conversion of audio files to WhatsApp-compatible formats using FFmpeg.
Tools
search_contacts
Search for contacts by name or phone number
list_messages
Retrieve messages with optional filters and context
list_chats
List available chats and their 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 specified recipient
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