WhatsApp Web MCP Server
WhatsApp Web MCP MCP server is a locally run integration for AI assistants that speak the Model Context Protocol. WhatsApp Web MCP Server.
A Node.js application that connects WhatsApp Web with AI models through the Model Context Protocol (MCP). This project provides a standardized interface for programmatic interaction with WhatsApp, enabling automated messaging, contact management, and group chat functionality through AI-driven workflows.
WhatsApp Web MCP provides a seamless integration between WhatsApp Web and AI models by:
Once WhatsApp Web MCP 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 groupdownload_media_from_message — Download media from a messagedirectly on npm is all you need. Most clients run it directly, so configuration is a few lines and a restart.
You 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.
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 Web MCP's toolset — get_status, send_message, search_contacts and 11 more — is a fair guide to whether it matches your workflow. It is maintained by pnizer; 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 |
| download_media_from_message | Download media from a message |
| send_media_message | Send a media message to a WhatsApp contact |
| 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 |
{
"mcpServers": {
"wweb": {
"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.