WhatsApp Web MCP
by pnizer
WhatsApp Web MCP is a Node.js application that connects WhatsApp Web with AI models through the Model Context Protocol (MCP). It provides a standardized interface for programmatic interaction with WhatsApp, enabling automated messaging and contact management.
Last updated: N/A
What is WhatsApp Web MCP?
WhatsApp Web MCP is a Node.js application that acts as a bridge between WhatsApp Web and AI models, using the Model Context Protocol (MCP). It offers a standardized way to interact with WhatsApp programmatically, enabling automated messaging, contact management, and group chat functionalities through AI-driven workflows.
How to use WhatsApp Web MCP?
To use WhatsApp Web MCP, you need to clone the repository, install the dependencies, and configure the application based on your desired mode (WhatsApp API Server or MCP Server). You can run it in standalone mode or connect it to a WhatsApp API server. Refer to the documentation for detailed instructions on installation, configuration, and running modes.
Key features of WhatsApp Web MCP
Standardized interface through Model Context Protocol (MCP)
MCP Server access to WhatsApp functionality
Flexible deployment options (SSE or Command modes)
Direct WhatsApp client integration and API-based connectivity
Sending and receiving messages
Group chat management
Contact management and search
REST API endpoints for various functionalities
Use cases of WhatsApp Web MCP
Automated customer support via WhatsApp
AI-powered chatbot integration with WhatsApp
Programmatic sending of notifications and alerts
Contact management and organization
Group messaging automation
Integration with Claude Desktop for AI interactions
FAQ from WhatsApp Web MCP
Is this project affiliated with WhatsApp?
Is this project affiliated with WhatsApp?
No, this project is not affiliated, associated, authorized, endorsed by, or in any way officially connected with WhatsApp or any of its subsidiaries or its affiliates.
Is it safe to use this tool without getting blocked?
Is it safe to use this tool without getting blocked?
It is not guaranteed you will not be blocked by using this method. WhatsApp does not allow bots or unofficial clients on their platform, so this shouldn't be considered totally safe.
What are the different running modes?
What are the different running modes?
The application can be run as a standalone WhatsApp API server, an MCP server that directly connects to WhatsApp Web, or an MCP server that connects to the WhatsApp API server.
How do I authenticate with WhatsApp?
How do I authenticate with WhatsApp?
You can use local authentication (recommended), which requires scanning a QR code once and persists credentials between sessions, or no authentication, which requires scanning a QR code on each startup.
How do I configure webhooks to receive incoming messages?
How do I configure webhooks to receive incoming messages?
You can configure webhooks by creating a webhook.json file in your authentication data directory, specifying the URL, authentication token, and filters for allowed numbers, private messages, and group messages.