WhatsApp MCP Server

@msaelices

代码仓库

基本信息

分类

沟通协作

许可证

MIT

传输方式

stdio

作者

msaelices

关于 WhatsApp MCP Server

Whatsapp MCP Server implemented in Python

WhatsApp MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

WhatsApp MCP Server 工具

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

概览

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

常见问题

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.

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.

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`.

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.

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.

沟通协作分类下的更多 MCP 服务器

SendRaven

CommonNinja

SendRaven is email infrastructure for AI agents. Send, read replies as threads, run campaigns and automations, with limits on the API key.

JooVoice

Give your AI agent a phone. JooVoice makes real calls for you in 80+ languages, with local accents, across 67 countries, like booking a table, moving an appointment or chasing a refund, and sends back what happened. Call

gtm-api

MCP server and API for AI agents that work LinkedIn on accounts you own: search, connect, message and enrich, with limits enforced on our server.

DashaMail

MCP server for DashaMail email marketing service

Faxer

1771 Co

Send real faxes to any US, Canadian, or international fax number from any AI assistant. The agent quotes the exact price from the document's real page count, hands the human a Stripe Checkout link (payment stays human-in