WhatsApp MCP Server
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Integrations
Enables messaging (send text messages) and group management (create groups, list members, add/remove participants) through the WhatsApp Business API via GreenAPI
WhatsApp MCP Server
A server that provides a Model Context Protocol (MCP) interface to interact with WhatsApp Business API.
Introduction
WhatsApp MCP Server is a Python implementation that enables language models like Claude to interact with WhatsApp functionality through GreenAPI.
Features
- Messaging: Send text messages
- Group Management: Create groups, list members, add/remove participants
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 instanceGREENAPI_API_TOKEN
: Your GreenAPI API token
You can either set these in your environment or use the provided .env
file (see Installation instructions).
Installation
Usage
Run the MCP server:
For debugging:
The server communicates through standard input/output streams using the Model Context Protocol (MCP).
Available Tools
open_session
: Open a new WhatsApp sessionsend_message
: Send a message to a chatget_chats
: Get a list of chatscreate_group
: Create a new WhatsApp groupget_group_participants
: Get the participants of a group
How to add it to Claude Code
To add a WhatsApp server to Claude, use the claude mcp add
command:
Using with Claude
Once the WhatsApp MCP server is running, you can interact with it using Claude in your conversations:
Authenticating with WhatsApp
Sending a message
Using with Claude Desktop
To use the WhatsApp MCP server with Claude Desktop, you need to add it to your claude_desktop_config.json
file:
Using pip installation (recommended)
Using the executable
Using Docker
Remember to set your GreenAPI credentials either as environment variables or in your .env
file before starting Claude Desktop.
Command-line options
The WhatsApp MCP server accepts these command-line arguments:
--debug
: Increase verbosity level for debugging
Debugging
For debugging the MCP server:
- Use MCP inspector:
npx @modelcontextprotocol/inspector whatsapp-mcp
- View logs in your Claude Desktop logs directory (typically
~/Library/Logs/Claude/
on macOS)
Development
The project uses a modern pyproject.toml
configuration which includes:
- Core dependencies needed for running the application
- Development dependencies available with
pip install -e ".[dev]"
License
This project is licensed under the MIT License - see the LICENSE file for details.
This server cannot be installed
A Python server that enables language models like Claude to interact with WhatsApp Business API through GreenAPI, supporting features like sending messages and managing groups.