Whatsapp Mcp2 MCP Server

WhatsApp Web MCP Server

Local serverstdioTypeScript

What is the Whatsapp Mcp2 MCP server?

Whatsapp Mcp2 MCP server is a locally run integration for AI assistants that speak the Model Context Protocol. WhatsApp Web MCP Server.

What you get

A powerful bridge between WhatsApp Web and AI models using the Model Context Protocol (MCP). This project enables AI models like Claude to interact with WhatsApp through a standardized interface, making it easy to automate and enhance WhatsApp interactions programmatically.

WhatsApp Web MCP provides a seamless integration between WhatsApp Web and AI models by: - Creating a standardized interface through the Model Context Protocol (MCP) - Offering MCP Server access to WhatsApp functionality - Providing flexible deployment options through SSE or Command modes - Supporting both direct WhatsApp client integration and API-based connectivity

What the assistant can call

Once Whatsapp Mcp2 is connected, these are the calls the assistant has available:

  • get_status — Check WhatsApp client connection status
  • send_message — Send messages to WhatsApp contacts
  • search_contacts — Search for contacts by name or number
  • get_messages — Retrieve messages from a specific chat
  • get_chats — Get a list of all WhatsApp chats
  • create_group — Create a new WhatsApp group
  • add_participants_to_group — Add participants to an existing group
  • get_group_messages — Retrieve messages from a group
  • send_group_message — Send a message to a group
  • search_groups — Search for groups by name, description, or member names
  • get_group_by_id — Get detailed information about a specific group
  • Components — 1. WhatsAppService: Core business logic for interacting with WhatsApp 2. WhatsAppApiClient: Client for connecting to the WhatsApp API 3

Configuration and credentials

You will need one environment variable: YOUR_API_KEY. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

Setting it up

directly on npm is all you need. Most clients run it directly, so configuration is a few lines and a restart.

Choosing this one

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 Mcp2's toolset — get_status, send_message, search_contacts and 10 more — is a fair guide to whether it matches your workflow. It is maintained by fyimail; 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.

Before you rely on it

  • 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 13 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Whatsapp Mcp2.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the whatsapp mcp2 mcp server does with a few real requests.

Available tools

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
Components1. **WhatsAppService**: Core business logic for interacting with WhatsApp 2. **WhatsAppApiClient**: Client for connecting to the WhatsApp API 3. **API Router**: Express routes for the REST API 4. **MCP Server**: Model Co
TestingThe Testing tool exposed by this server.

How to install the Whatsapp Mcp2 MCP server

{
  "mcpServers": {
    "whatsapp-mcp2": {
      "command": "npx",
      "args": ["-y", "directly"],
      "env": {
        "YOUR_API_KEY": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
YOUR_API_KEYCredential the server authenticates with.Yes

Example prompts to try

  • Use Whatsapp Mcp2 to get status.
  • Use Whatsapp Mcp2 to send message.
  • Use Whatsapp Mcp2 to search contacts.

Frequently asked questions

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