whatsapp-mcp
Summary
This is a Model Context Protocol (MCP) server for WhatsApp.
With this you can search and read your personal Whatsapp messages (including images, videos, documents, and audio messages), search your contacts and send messages to either individuals or groups. You can also send media files including images, videos, documents, and audio messages.
It connects to your personal WhatsApp account directly via the Whatsapp web multidevice API (using the whatsmeow library). All your messages are stored locally in a SQLite database and only sent to an LLM (such as Claude) when the agent accesses them through tools (which you control).
Available Actions(12)
search_contacts
Search for contacts by name or phone number.
list_messages
Retrieve messages with optional filters and context.
list_chats
List available chats with metadata.
get_chat
Get information about a specific chat.
get_direct_chat_by_contact
Find a direct chat with a specific contact.
get_contact_chats
List all chats involving a specific contact.
get_last_interaction
Get the most recent message with a contact.
get_message_context
Retrieve context around a specific message.
send_message
Send a WhatsApp message to a specified phone number or group JID.
send_file
Send a file (image, video, raw audio, document) to a specified recipient.
send_audio_message
Send an audio file as a WhatsApp voice message (requires the file to be an .ogg opus file or ffmpeg must be installed).
download_media
Download media from a WhatsApp message and get the local file path.
Community Reviews
No reviews yet. Be the first to review!
Sign in to join the conversation
