WhatsApp MCP Server — Chat with WhatsApp via AI Agents

What it is

The WhatsApp MCP Server connects AI assistants like Claude to your personal WhatsApp account via the Model Context Protocol. Once configured, your AI agent can search contacts, read message history, send text replies, and share media files -- all through natural language commands.

It is intended for power users and developers who want to automate WhatsApp interactions, build chatbot workflows, or let their AI assistant handle routine messaging tasks.

How it saves time or tokens

Instead of switching between your AI assistant and WhatsApp manually, this MCP server lets the agent act on your behalf directly. Reading unread messages, summarizing conversations, and drafting replies happen in a single agent session without context-switching overhead.

How to use

1. Install the WhatsApp MCP server package and configure it with your MCP client (e.g., Claude Desktop or Claude Code).
2. Authenticate by scanning a QR code with your WhatsApp mobile app to link the session.
3. Use natural language commands like 'read my latest messages' or 'send a message to John saying I will be late' through your AI agent.

Example

{
  "mcpServers": {
    "whatsapp": {
      "command": "npx",
      "args": ["-y", "whatsapp-mcp-server"],
      "env": {
        "WHATSAPP_SESSION_DIR": "~/.whatsapp-mcp"
      }
    }
  }
}

Related on TokRepo

• MCP integrations -- Explore other MCP server integrations like Slack.
• AI tools for automation -- Browse automation-focused AI tools.

Common pitfalls

• WhatsApp sessions expire if your phone is offline for extended periods. Keep your phone connected to maintain the linked session.
• Sending too many automated messages risks triggering WhatsApp's anti-spam detection. Rate-limit outgoing messages.
• The MCP server accesses your personal WhatsApp, not the WhatsApp Business API. It is not suitable for high-volume business messaging.
• QR code re-authentication is required after session expiry or WhatsApp app updates.
• Media files sent through the MCP server must be under WhatsApp's size limits (16 MB for most media types).