Whatsapp MCP Go MCP Server

With this you can search and read your personal Whatsapp messages (including images, videos, documents, and audio messages), search your contacts and

Local serverstdioPython

What is the Whatsapp MCP Go MCP server?

If you already use Whatsapp MCP Go, the whatsapp mcp go mcp server is the piece that lets your assistant work with it directly. 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.

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

Plenty of team communication servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Whatsapp MCP Go'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 tonydgbd; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

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 Go.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

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
PrerequisitesThe Prerequisites tool exposed by this server.
StepsNavigate to the whatsapp-bridge directory and run the Go application:

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 Go to search contacts.
  • Use Whatsapp MCP Go to list messages.
  • Use Whatsapp MCP Go to list chats.

Frequently asked questions

It connects Whatsapp MCP Go to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (search_contacts, list_messages, list_chats, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Whatsapp MCP Go directly.