drio
Open app

WhatsApp Web MCP

Source

WhatsApp Web MCP Server

Catalog onlyCatalog onlySTDIO

Overview

WhatsApp Web MCP is a powerful bridge between WhatsApp Web and AI models using the Model Context Protocol (MCP). It enables AI models to interact with WhatsApp through a standardized interface, facilitating automation and enhancement of WhatsApp interactions programmatically.

To use WhatsApp Web MCP, clone the repository from GitHub, install the necessary packages, and run the server in either WhatsApp API mode or MCP mode. You can also integrate it with AI models like Claude for enhanced functionality.

  • Standardized interface for WhatsApp interactions via MCP. - Flexible deployment options (SSE or Command modes). - Support for both direct WhatsApp client integration and API-based connectivity. - Tools for sending messages, checking status, and retrieving chats.
  1. Automating message sending to WhatsApp contacts.
  2. Integrating AI models for enhanced chat interactions.
  3. Building applications that require WhatsApp functionality through a REST API.

Add to your AI client

Use these steps to connect WhatsApp Web MCP in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "wweb-mcp-pnizer": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-wweb-mcp-pnizer"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "wweb-mcp-pnizer": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-wweb-mcp-pnizer"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "wweb-mcp-pnizer": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-wweb-mcp-pnizer"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "wweb-mcp-pnizer": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-wweb-mcp-pnizer"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "wweb-mcp-pnizer": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-wweb-mcp-pnizer"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "wweb-mcp-pnizer": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-wweb-mcp-pnizer"
      ]
    }
  }
}

FAQ

Is this project affiliated with WhatsApp?

No, this project is not affiliated with WhatsApp and is intended for testing purposes only.

Can I use this in production?

It is not recommended to use this tool in production environments due to potential risks of being blocked by WhatsApp.

What are the authentication methods?

You can use local authentication for persistent sessions or no authentication for testing.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":2903,"uuid":"5127bb2a-2015-4312-975c-52b90e3f5aa2","name":"wweb-mcp","title":"WhatsApp Web MCP","description":"WhatsApp Web MCP Server","avatar_url":"https://avatars.githubusercontent.com/u/7586240?v=4","created_at":"2025-03-16T04:05:49.936Z","updated_at":"2025-03-16T05:49:20.834Z","status":"created","author_name":"pnizer","author_avatar_url":"https://avatars.githubusercontent.com/u/7586240?v=4","tags":"mcp,whatsapp","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/pnizer/wweb-mcp","target":"_self","content":"$29","summary":"$2a","img_url":"https://github.com/pnizer/wweb-mcp/actions/workflows/pr-checks.yml/badge.svg","type":null,"metadata":"{\"star\":\"18\",\"license\":\"MIT license\",\"language\":\"TypeScript\",\"is_official\":false,\"latest_commit_time\":\"2025-04-12 19:31:08\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Developer tools