drio
Open app

WhatsApp MCP Server

Source

Whatsapp MCP Server implemented in Python

Catalog onlyCatalog onlySTDIO

Overview

WhatsApp MCP Server is a Python implementation that provides a Model Context Protocol (MCP) interface to interact with the WhatsApp Business API, enabling language models to utilize WhatsApp functionalities.

To use the WhatsApp MCP Server, clone the repository, install the dependencies, set up your environment variables with your GreenAPI credentials, and run the server using the command whatsapp-mcp.

  • Messaging: Send text messages through WhatsApp. - Group Management: Create groups, list members, and add/remove participants. - Integration with Claude: Easily add the server to Claude for enhanced interactions.
  1. Automating customer support via WhatsApp.
  2. Sending notifications and alerts to users through WhatsApp messages.
  3. Managing group communications for teams or communities.

Add to your AI client

Use these steps to connect WhatsApp MCP Server 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": {
    "whatsapp-mcp-server-msaelices": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-whatsapp-mcp-server-msaelices"
      ]
    }
  }
}

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": {
    "whatsapp-mcp-server-msaelices": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-whatsapp-mcp-server-msaelices"
      ]
    }
  }
}

Claude Code

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

.mcp.json (project root)

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

VS Code (Copilot)

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

.vscode/mcp.json

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

Windsurf

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

~/.codeium/windsurf/mcp_config.json

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

Cline

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

Cline MCP Settings (via UI)

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

FAQ

**What is required to use the WhatsApp MCP Server?**

You need a GreenAPI account and your API credentials to interact with the WhatsApp Cloud API.

**Is the WhatsApp MCP Server free to use?**

The server itself is free, but using the WhatsApp API through GreenAPI may incur costs.

**Can I run the server locally?**

Yes, you can run the server locally after setting up the necessary environment variables.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":2521,"uuid":"36393494-626d-4aae-b598-5166e66e1da5","name":"whatsapp-mcp-server","title":"WhatsApp MCP Server","description":"Whatsapp MCP Server implemented in Python","avatar_url":"https://avatars.githubusercontent.com/u/136875?v=4","created_at":"2025-03-13T08:36:13.481Z","updated_at":"2025-03-13T08:39:35.895Z","status":"created","author_name":"msaelices","author_avatar_url":"https://avatars.githubusercontent.com/u/136875?v=4","tags":"[]","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/msaelices/whatsapp-mcp-server","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":"{\"star\":\"4\",\"license\":\"MIT license\",\"language\":\"Python\",\"is_official\":false,\"latest_commit_time\":\"2025-04-04 13:51:37\"}","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