Whatsapp MCP Server

Connect Whatsapp MCP to Claude, Cursor or any other MCP client and it stops being a tab you switch to. 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. The whatsapp mcp mcp server is what makes that connection.

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

• 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

Installation

Setup follows the usual MCP pattern — install or clone the server, register it in your client's configuration file, restart the client.

Credentials and setup notes

• Go - Python 3.6+ - Anthropic Claude Desktop app (or Cursor) - UV (Python package manager), install with curl -LsSf https://astral.sh/uv/install.sh | sh - FFmpeg (optional) - Only needed for audio messages. If you want to send audio files as playable WhatsApp voice messages, they must be in .ogg Opus format. With FFmpeg installed, the MCP server will automatically convert non-Opus audio

Where it fits

Among the team communication options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Whatsapp MCP's toolset — search_contacts, list_messages, list_chats and 11 more — is a fair guide to whether it matches your workflow. It is maintained by aukik; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Worth knowing first

• It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
• With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Whatsapp MCP.
• Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.