WhatsApp Web MCP Server

WhatsApp Web MCP Server

Local serverstdioPython

What is the WhatsApp Web MCP Server?

WhatsApp Web MCP Server

What you get

A Node.js application that connects WhatsApp Web with AI models through the Model Context Protocol (MCP). This project provides a standardized interface for programmatic interaction with WhatsApp, enabling automated messaging, contact management, and group chat functionality through AI-driven workflows.

WhatsApp Web MCP provides a seamless integration between WhatsApp Web and AI models by:

  • Sending and receiving messages
  • Sending media messages (images only)
  • Downloading media from messages (images, audio, documents)
  • Group chat management
  • Contact management and search
  • Message history retrieval

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
get_statusCheck WhatsApp client connection status
send_messageSend messages to WhatsApp contacts
search_contactsSearch for contacts by name or number
get_messagesRetrieve messages from a specific chat
get_chatsGet a list of all WhatsApp chats
create_groupCreate a new WhatsApp group
add_participants_to_groupAdd participants to an existing group
get_group_messagesRetrieve messages from a group
send_group_messageSend a message to a group
search_groupsSearch for groups by name, description, or member names
get_group_by_idGet detailed information about a specific group
download_media_from_messageDownload media from a message
send_media_messageSend a media message to a WhatsApp contact

Example prompts to try

  • “Use WhatsApp Web MCP to get status.”
  • “Use WhatsApp Web MCP to send message.”
  • “Use WhatsApp Web MCP to search contacts.”

Frequently asked questions

No. The README explicitly states the tool is for testing purposes only and should not be used in production environments. It also notes that WhatsApp does not allow bots or unofficial clients, so using it may result in account blocking.