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
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageReadme
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.
WhatsApp MCP
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.
Details
Related Communication & Messaging MCP servers
View all
Slackkorotovsky/slack-mcp-serverProvides Slack workspace access via MCP with channels, DMs, history, search, and safe posting via multiple transports.1.6Kstars
Hex Linelevnikolaevich/claude-code-skillsHash-verified file editing MCP server with token efficiency hook for AI coding agents.0stars
Discordsaseq/discord-mcpA MCP server for the Discord integration. Enable your AI assistants to seamlessly interact with Discord. Enhance your Discord experience with powerful automatio310stars
Technocore Chatflop-labs/technocore-chatShared rooms and durable notes for agents over plain HTTP: rendezvous, hand-off, coordination.167stars
Slackpulsemcp/mcp-serversMCP server for Slack — read/write messages, manage threads, and react to messages.0stars
Fast MCP Telegramleshchenko1979/fast-mcp-telegramMulti-tenant Telegram gateway for AI agents — HTTP+stdio, 8 tools, MTProto User API50stars