WhatsApp MCP Server
About
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.
Details
- Author
- msaelices
- GitHub stars
- 25
- Downloads
- 616
- Categories
- Communication
Jump to
- 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
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
WhatsApp MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"whatsapp mcp server": {
"whatsapp": {
"command": "python",
"args": [
"-m",
"whatsapp_mcp"
],
"env": {
"GREENAPI_ID_INSTANCE": "",
"GREENAPI_API_TOKEN": ""
}
}
}
}
}McpServers
{
"whatsapp": {
"command": "python",
"args": [
"-m",
"whatsapp_mcp"
],
"env": {
"GREENAPI_ID_INSTANCE": "",
"GREENAPI_API_TOKEN": ""
}
}
}WhatsApp MCP Server
A server that provides a Model Context Protocol (MCP) interface to interact with WhatsApp Business API using FastMCP.
Introduction
WhatsApp MCP Server is a Python implementation that enables language models like Claude to interact with WhatsApp functionality through GreenAPI. It leverages FastMCP for improved performance, better developer experience, and a cleaner implementation.
Features
- Messaging: Send text messages to WhatsApp contacts
- Group Management: Create groups, list members, add/remove participants
- Session Handling: Manage WhatsApp API sessions
- Chat History: Retrieve chat lists and message history
WhatsApp API Client
This project uses the whatsapp-api-client-python library to interact with WhatsApp. The client provides access to the WhatsApp Cloud API, which requires a GreenAPI account to use.
Environment Variables
This project uses environment variables for configuration:
- GREENAPI_ID_INSTANCE: Your GreenAPI ID instance
- GREENAPI_API_TOKEN: Your GreenAPI API token
You can either set these in your environment or use the provided .env file (see Installation instructions).
Installation
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
