lharries/whatsapp-mcp
The WhatsApp MCP server enables LLMs to search and read personal WhatsApp messages (including media files), query contacts, and send messages to individuals or groups by connecting directly to a user's WhatsApp account via the WhatsApp web multidevice API. It stores all messages locally in a SQLite database and only transmits data to the LLM when explicitly accessed through tools, giving users control over what information is shared. This allows AI assistants like Claude to have contextual access to a user's WhatsApp conversations and the ability to compose and send messages on their behalf.
- GitHub stars
- 5.6K
- tools
- 12
- last updated
- Dec 15, 2025
Tools
12 toolsPublic tool metadata for what this MCP can expose to an agent.
search_contactsSearch for contacts by name or phone number
Search for contacts by name or phone number
No parameter schema in public metadata yet.
list_messagesRetrieve messages with optional filters and context
Retrieve messages with optional filters and context
No parameter schema in public metadata yet.
list_chatsList available chats with metadata
List available chats with metadata
No parameter schema in public metadata yet.
get_chatGet information about a specific chat
Get information about a specific chat
No parameter schema in public metadata yet.
get_direct_chat_by_contactFind a direct chat with a specific contact
Find a direct chat with a specific contact
No parameter schema in public metadata yet.
get_contact_chatsList all chats involving a specific contact
List all chats involving a specific contact
No parameter schema in public metadata yet.
get_last_interactionGet the most recent message with a contact
Get the most recent message with a contact
No parameter schema in public metadata yet.
get_message_contextRetrieve context around a specific message
Retrieve context around a specific message
No parameter schema in public metadata yet.
send_messageSend a WhatsApp message to a specified phone number or group JID
Send a WhatsApp message to a specified phone number or group JID
No parameter schema in public metadata yet.
send_fileSend a file (image, video, raw audio, document) to a specified recipient
Send a file (image, video, raw audio, document) to a specified recipient
No parameter schema in public metadata yet.
send_audio_messageSend an audio file as a WhatsApp voice message (requires the file to be an .ogg opus file or ffmpeg must be installed)
Send an audio file as a WhatsApp voice message (requires the file to be an .ogg opus file or ffmpeg must be installed)
No parameter schema in public metadata yet.
download_mediaDownload media from a WhatsApp message and get the local file path
Download media from a WhatsApp message and get the local file path
No parameter schema in public metadata yet.
Sponsors
Promote your product here
Agent CaffeineSponsoredClose your lid, come back to finished work
LLMond HighlightsSponsoredThe AI tools worth your time, every Monday
SnugSponsoredThe clipboard manager you and your agent can use, safely
Vinena StudioSponsoredWe build premium apps, websites and AI workflows for you
knobsSponsoredSee your site on any phone, any day, in any language
AcheliaSponsoredNative herdr client for iOS and macOS
WaxSponsoredBlock anything with supervision, without erasing your iPhone
Agent CaffeineSponsoredClose your lid, come back to finished workLLMond HighlightsSponsoredThe AI tools worth your time, every MondaySnugSponsoredThe clipboard manager you and your agent can use, safelyVinena StudioSponsoredWe build premium apps, websites and AI workflows for youknobsSponsoredSee your site on any phone, any day, in any languageAcheliaSponsoredNative herdr client for iOS and macOSWaxSponsoredBlock anything with supervision, without erasing your iPhoneReadme
WhatsApp MCP Server
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).
Here's an example of what you can do when it's connected to Claude.
To get updates on this and other projects I work on enter your email here
Caution: as with many MCP servers, the WhatsApp MCP is subject to the lethal trifecta. This means that project injection could lead to private data exfiltration.
