WhatsApp MCP Server

Send and receive messages using the WhatsApp API.

Local serverstdioPython

What is the WhatsApp MCP Server?

Send and receive messages using the WhatsApp API.

What you get

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.

Configuration and credentials

  • 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

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
search_contactsSearch for contacts by name or phone number
list_messagesRetrieve messages with optional filters and context
list_chatsList available chats with metadata
get_chatGet information about a specific chat
get_direct_chat_by_contactFind a direct chat with a specific contact
get_contact_chatsList all chats involving a specific contact
get_last_interactionGet the most recent message with a contact
get_message_contextRetrieve context around a specific message
send_messageSend a WhatsApp message to a specified phone number or group JID
send_fileSend a file (image, video, raw audio, document) to a specified recipient
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)
download_mediaDownload media from a WhatsApp message and get the local file path

Configuration

  • 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

Example prompts to try

  • “Use WhatsApp MCP to search contacts.”
  • “Use WhatsApp MCP to list messages.”
  • “Use WhatsApp MCP to list chats.”