Frequently Asked Questions about WhatsApp MCP Server

Q: What is an MCP Server? A: MCP stands for Model Context Protocol. An MCP server acts as a bridge, standardizing how applications provide context to Large Language Models (LLMs), enabling AI models to access and interact with external data sources and tools.

Q: What does this WhatsApp MCP Server do? A: This server connects your personal WhatsApp account to an AI agent (like Anthropic Claude or Cursor), allowing the agent to search your messages, contacts, and chats, as well as send messages on your behalf.

Q: Is my data secure? A: Yes, all your messages and authentication details are stored locally on your computer in a SQLite database and authentication cache. Data is only sent to the connected AI agent when it explicitly uses one of the provided MCP tools.

Q: What AI clients are compatible with this server? A: This server is compatible with any AI client that supports the Model Context Protocol, such as Anthropic Claude (via its desktop app), Cursor, Cline or Roo Code.

Q: What are the prerequisites for installing this server? A: You need Node.js (version 23.10.0 or higher), npm (or yarn/pnpm), and a compatible AI client like Anthropic Claude Desktop or Cursor.

Q: How do I install the server? A: You can install it via Smithery using the provided command, or manually by cloning the repository, installing dependencies, and running the server.

Q: How do I configure my AI client to use this server? A: You need to create a configuration JSON file (e.g., claude_desktop_config.json for Claude Desktop or mcp.json for Cursor) with the correct path to the server’s main.ts file and save it in the appropriate configuration directory.

Q: How do I find the absolute path to the repository? A: Navigate to the whatsapp-mcp-ts directory in your terminal and run pwd. The output is the absolute path.

Q: What if the QR code doesn’t open automatically? A: Check the console output for the quickchart.io URL and open it manually in your browser.

Q: What if I get a DisconnectReason.loggedOut error? A: You need to re-authenticate. Stop the server, delete the ./auth_info/ directory, and restart the server to get a new QR code.

Q: What if messages seem out of sync or missing? A: You might need a full reset. Stop the server, delete both ./auth_info/ and ./data/ directories, then restart the server to re-authenticate and resync history.

Q: How do I troubleshoot connection problems with Claude or Cursor? A: Double-check the command and args in your configuration file, ensure the path is absolute and correct, verify Node.js is installed correctly, and check the AI client’s and server’s logs for errors.

Q: What is UBOS and how does it relate to this MCP server? A: UBOS is a full-stack AI Agent Development Platform that can help you orchestrate AI Agents, connect them with your enterprise data, build custom AI Agents with your LLM model, and develop Multi-Agent Systems. This MCP server provides a way to connect WhatsApp to your AI agents within the UBOS ecosystem.