What is the MCP WhatsApp Web server?

The MCP WhatsApp Web server is a TypeScript-based implementation that allows AI agents to access and interact with WhatsApp data. It enables features like searching messages, managing contacts, sending messages, and handling media.

What is MCP?

MCP (Model Context Protocol) is an open protocol that standardizes how applications provide context to LLMs. It acts as a bridge, allowing AI models to access and interact with external data sources and tools.

What are the prerequisites for installing the MCP WhatsApp Web server?

You need Node.js >= 18.0.0, npm or yarn, Chrome/Chromium (for WhatsApp Web connection), and FFmpeg (optional, for audio message conversion).

How do I install the MCP WhatsApp Web server?

You can install it manually by cloning the repository, installing dependencies, and building the project, or using FLUJO for a streamlined installation process.

How do I authenticate with WhatsApp?

Start the server and use the get_qr_code tool to generate a QR code. Scan the QR code with your WhatsApp mobile app (Settings > Linked Devices > Link a Device).

What is UBOS?

UBOS is a full-stack AI Agent Development Platform that helps you orchestrate AI Agents, connect them with your enterprise data, build custom AI Agents with your LLM model and Multi-Agent Systems.

How does integrating with UBOS enhance the MCP WhatsApp Web server?

Integrating with UBOS allows you to seamlessly connect your AI agents to WhatsApp data, orchestrate complex AI workflows, build custom AI agents, and leverage UBOS’s comprehensive features for data integration and agent management.

What are some common use cases for the MCP WhatsApp Web server?

Use cases include AI-powered customer support, automated notifications, personalized marketing campaigns, sentiment analysis, content creation, and task automation.

What transport options does the server support?

The server supports both stdio and SSE transports for flexible integration.

What should I do if I encounter authentication issues?

Restart the server, ensure you’re not already authenticated, use the logout tool if needed, and check that you haven’t exceeded the limit of linked devices on WhatsApp.

What should I do if I encounter browser process issues?

Run npm run cleanup-browsers to detect and clean up orphaned Chrome processes. You can also manually check for orphaned processes using Task Manager (Windows) or ps aux | grep chrome (Linux/macOS).

How do I check my authentication status?

Use the check_auth_status tool to verify if you’re currently authenticated with WhatsApp.