Question 1

What is an MCP Server?

Accepted Answer

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.

Question 2

What does this WhatsApp MCP Server do?

Accepted Answer

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.

Question 3

Is my data secure?

Accepted Answer

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.

Question 4

What AI clients are compatible with this server?

Accepted Answer

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.

Question 5

What are the prerequisites for installing this server?

Accepted Answer

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.

Question 6

How do I install the server?

Accepted Answer

You can install it via Smithery using the provided command, or manually by cloning the repository, installing dependencies, and running the server.

Question 7

How do I configure my AI client to use this server?

Accepted Answer

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.

Question 8

How do I find the absolute path to the repository?

Accepted Answer

Navigate to the `whatsapp-mcp-ts` directory in your terminal and run `pwd`. The output is the absolute path.

Question 9

What if the QR code doesn't open automatically?

Accepted Answer

Check the console output for the `quickchart.io` URL and open it manually in your browser.

Question 10

What if I get a `DisconnectReason.loggedOut` error?

Accepted Answer

You need to re-authenticate. Stop the server, delete the `./auth_info/` directory, and restart the server to get a new QR code.

Question 11

What if messages seem out of sync or missing?

Accepted Answer

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.

Question 12

How do I troubleshoot connection problems with Claude or Cursor?

Accepted Answer

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.

Question 13

What is UBOS and how does it relate to this MCP server?

Accepted Answer

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.

WhatsApp Personal Account Connector

Resources

Project Details

Recomended MCP Servers

Featured Templates

Unified Authorization Template

Calculate Time Complexity with ChatGPT API

AI Chatbot Starter Kit v0.1

Multi-language AI Translator

AI Chatbot Starter Kit

Speech to Text

Start your free trial