WhatsApp Web MCP Server
Whatsapp Mcp2 MCP server is a locally run integration for AI assistants that speak the Model Context Protocol. WhatsApp Web MCP Server.
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
Once Whatsapp Mcp2 is connected, these are the calls the assistant has available:
get_status — Check WhatsApp client connection statussend_message — Send messages to WhatsApp contactssearch_contacts — Search for contacts by name or numberget_messages — Retrieve messages from a specific chatget_chats — Get a list of all WhatsApp chatscreate_group — Create a new WhatsApp groupadd_participants_to_group — Add participants to an existing groupget_group_messages — Retrieve messages from a groupsend_group_message — Send a message to a groupsearch_groups — Search for groups by name, description, or member namesget_group_by_id — Get detailed information about a specific groupComponents — 1. WhatsAppService: Core business logic for interacting with WhatsApp 2. WhatsAppApiClient: Client for connecting to the WhatsApp API 3You 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.
directly on npm is all you need. Most clients run it directly, so configuration is a few lines and a restart.
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.
| Tool | What it does |
|---|---|
| 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. **API Router**: Express routes for the REST API 4. **MCP Server**: Model Co |
| Testing | The Testing tool exposed by this 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.
| Variable | Description | Required |
|---|---|---|
| YOUR_API_KEY | Credential the server authenticates with. | Yes |
Your assistant inside the workspace — read channels, search history, post messages and tame the noise.
Inbox intelligence — search, read, draft and send Gmail through your assistant with OAuth auto-setup.
Read and write Jira, Confluence, Bitbucket, JSM and Compass from your AI client — with your own permissions.
Read and send Telegram messages through your assistant — chats, channels and history via the client API.
Enables Discord bot integration with Model Context Protocol (MCP) compatible applications like Claude Desktop.
Exposes REST APIs defined by OpenAPI specifications as Model Context Protocol (MCP) tools, facilitating seamless integration into MCP-based workflows.