WhatsApp MCP Server
by lharries
The WhatsApp MCP Server allows you to connect your personal WhatsApp account to an LLM like Claude. It enables searching, reading, and sending messages, including media, through the Model Context Protocol.
Last updated: N/A
What is WhatsApp MCP Server?
The WhatsApp MCP Server is a bridge that connects your personal WhatsApp account to a Large Language Model (LLM) such as Claude, enabling you to interact with your WhatsApp data through the LLM's interface. It utilizes the WhatsApp web multidevice API and stores messages locally in a SQLite database.
How to use WhatsApp MCP Server?
To use the server, you need to clone the repository, run the Go WhatsApp bridge (authenticating via QR code), configure the MCP server settings in Claude or Cursor, and restart the application. This allows Claude to access WhatsApp as an available integration.
Key features of WhatsApp MCP Server
Search and read WhatsApp messages (including media)
Search contacts and send messages to individuals or groups
Send media files (images, videos, documents, audio)
Local storage of messages in a SQLite database
Integration with LLMs like Claude via Model Context Protocol (MCP)
Supports sending audio messages as playable voice messages
Supports downloading media from messages
Use cases of WhatsApp MCP Server
Automated WhatsApp interactions through Claude
AI-powered message searching and filtering
Contextual WhatsApp conversations with LLM assistance
Programmatic sending of WhatsApp messages and media
Analyzing WhatsApp communication patterns using LLMs
FAQ from WhatsApp MCP Server
How do I authenticate with WhatsApp?
How do I authenticate with WhatsApp?
You need to scan the QR code displayed by the Go WhatsApp bridge using your WhatsApp mobile app.
Where are my WhatsApp messages stored?
Where are my WhatsApp messages stored?
All your messages are stored locally in a SQLite database within the whatsapp-bridge/store/ directory.
What is the Model Context Protocol (MCP)?
What is the Model Context Protocol (MCP)?
MCP is a standardized protocol that allows LLMs like Claude to interact with external data sources and tools, in this case, your WhatsApp data.
What media types are supported?
What media types are supported?
The server supports sending and receiving images, videos, documents, and audio messages. Audio files can be sent as playable voice messages if they are in .ogg Opus format or if FFmpeg is installed.
What do I do if the QR code doesn't display?
What do I do if the QR code doesn't display?
Try restarting the authentication script. If issues persist, check if your terminal supports displaying QR codes.