whatsapp-mcp

Level ALocal

WhatsApp MCP server

Overview

An MCP server that connects an AI assistant to your personal WhatsApp account. Search and read chats including images, videos, documents and audio, look up contacts, and send messages or media to individuals and groups, including voice messages. History is stored in a local SQLite database and only passed to the LLM when accessed through tools. Tools cover contact search, chat listing, message context, sending files, and media download.

⭐ 6.9kDevelopment ToolsGoRepo ↗Updated 2025-07-13

Installation

MCP client config (paste into mcp.json)

{
  "mcpServers": {
    "lharries-whatsapp-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/whatsapp-mcp/whatsapp-mcp-server",
        "run",
        "main.py"
      ]
    }
  }
}

Agent install prompt

Copy and paste into Cursor / Claude / other agents to install this MCP for you

Please read this MCP repository and install it into my current environment:
https://github.com/lharries/whatsapp-mcp

Known working client config (can write into mcp.json):
{
  "mcpServers": {
    "lharries-whatsapp-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/whatsapp-mcp/whatsapp-mcp-server",
        "run",
        "main.py"
      ]
    }
  }
}

Please: 1) check README for deps and env vars; 2) write config for my client; 3) if secrets are missing, tell me what to fill — do not invent values.

Related servers