Advertise
MCP.so
Sign In

WhatsApp MCP Server

@msaelices

Repository

Basic information

Category

Communication

Last updated

License

MIT

Transports

stdio

Author

msaelices

About WhatsApp MCP Server

Whatsapp MCP Server implemented in Python

WhatsApp MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "whatsapp": {
      "command": "python",
      "args": [
        "-m",
        "whatsapp_mcp"
      ],
      "env": {
        "GREENAPI_ID_INSTANCE": "",
        "GREENAPI_API_TOKEN": ""
      }
    }
  }
}

WhatsApp MCP Server tools

5

Open a new WhatsApp session

Send a message to a chat

Get a list of chats

Create a new WhatsApp group

Get the participants of a group

Overview

What is WhatsApp MCP Server?

WhatsApp MCP Server is a Python implementation that provides a Model Context Protocol (MCP) interface to interact with WhatsApp Business API through GreenAPI. It enables language models like Claude to send messages, manage groups, handle sessions, and retrieve chat history.

How to use WhatsApp MCP Server?

Install the package with pip install -e ., set your GreenAPI credentials in the .env file (GREENAPI_ID_INSTANCE and GREENAPI_API_TOKEN), then run the server with the whatsapp-mcp command. The server can be added to Claude Code using claude mcp add whatsapp -- whatsapp-mcp or configured in Claude Desktop via claude_desktop_config.json.

Key features of WhatsApp MCP Server

  • Send text messages to WhatsApp contacts
  • Create and manage WhatsApp groups
  • List, add, and remove group participants
  • Manage WhatsApp API sessions
  • Retrieve chat lists and message history

Use cases of WhatsApp MCP Server

  • Send automated messages from an AI assistant
  • Manage group membership programmatically
  • Retrieve conversation history for analysis
  • Integrate WhatsApp messaging with Claude or other MCP hosts

Frequently asked questions

1

What is GreenAPI?

GreenAPI is a third-party service that provides access to the WhatsApp Cloud API. You need a GreenAPI account and your instance ID and API token to use the server.

2

How do I authenticate with WhatsApp MCP Server?

Set the environment variables `GREENAPI_ID_INSTANCE` and `GREENAPI_API_TOKEN` in your `.env` file or export them in your shell.

3

What transport protocols does the server support?

The server supports both HTTP and WebSocket endpoints via FastMCP, available at `http://localhost:8000/mcp` and `ws://localhost:8000/mcp`.

4

How do I add WhatsApp MCP Server to Claude Desktop?

Add an entry to your `claude_desktop_config.json` under `mcpServers` with either `"python -m whatsapp_mcp"` as the command or `"whatsapp-mcp"`, and set your GreenAPI credentials.

5

Can I run the server with Docker?

Yes, the README provides a Docker configuration example for `claude_desktop_config.json` using `docker run` with the environment variables passed inline.

Comments

More Communication MCP servers

Atomic Mail Agentic

Atomic-Mail

Let your agents read, send and react to email autonomously, without human involvement

255

B2B Creators

Social Tree Global

Agencies and GTM teams use HeyReach and Instantly to run LinkedIn outbound from personal sender profiles — but those profiles sit empty and prospects don't accept. B2B Creators is the content layer that keeps every sende

Canarics

Canarics

AI call analysis and voice agents for sales teams. This MCP server lets a team's own AI assistant read minute usage, agents, call summaries and daily stats, look up caller history, schedule consent-gated AI callbacks, an

2pr.io

2pr.io

Write, schedule and publish LinkedIn posts in your own voice, reply to comments and read your analytics, all from your AI assistant. Remote MCP server with OAuth sign-in.

ARVX

Centric AI, Inc.

ARVX™ reads client relationship health using the science of why partnerships last. It models two people, factors in what's influencing each of them, and reads their relationship across five areas, with what moved since t

Advertise