WhatsApp MCP Server

by nakulbenio.github.nakulben/whatsapp-mcpv0.1.0

Manage WhatsApp Business message templates via the Meta Cloud API: create, validate and send all template types, including carousel, catalog and flows.

3Pythonstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Stale6mo ago

Install WhatsApp MCP server

claude mcp add jina-whatsapp -e META_ACCESS_TOKEN='<meta-access-token>' -e META_WABA_ID='<meta-waba-id>' -e META_PHONE_NUMBER_ID='<meta-phone-number-id>' -- uvx jina-whatsapp-mcp

{
  "mcpServers": {
    "jina-whatsapp": {
      "command": "uvx",
      "args": [
        "jina-whatsapp-mcp"
      ],
      "env": {
        "META_ACCESS_TOKEN": "<meta-access-token>",
        "META_WABA_ID": "<meta-waba-id>",
        "META_PHONE_NUMBER_ID": "<meta-phone-number-id>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "jina-whatsapp": {
      "command": "uvx",
      "args": [
        "jina-whatsapp-mcp"
      ],
      "env": {
        "META_ACCESS_TOKEN": "<meta-access-token>",
        "META_WABA_ID": "<meta-waba-id>",
        "META_PHONE_NUMBER_ID": "<meta-phone-number-id>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "jina-whatsapp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "jina-whatsapp-mcp"
      ],
      "env": {
        "META_ACCESS_TOKEN": "<meta-access-token>",
        "META_WABA_ID": "<meta-waba-id>",
        "META_PHONE_NUMBER_ID": "<meta-phone-number-id>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "jina-whatsapp": {
      "command": "uvx",
      "args": [
        "jina-whatsapp-mcp"
      ],
      "env": {
        "META_ACCESS_TOKEN": "<meta-access-token>",
        "META_WABA_ID": "<meta-waba-id>",
        "META_PHONE_NUMBER_ID": "<meta-phone-number-id>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
META_ACCESS_TOKEN	yes	yes	Meta API access token with whatsapp_business_messaging and whatsapp_business_management permissions
META_WABA_ID	yes	—	WhatsApp Business Account ID
META_PHONE_NUMBER_ID	yes	—	WhatsApp phone number ID
META_APP_ID	—	—	Meta app ID (for media uploads)
META_API_VERSION	—	—	Meta Graph API version (defaults to v24.0)

Freshness

Stale — last maintenance signal 6mo ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-04-04 · 6mo ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-04-04 · 6mo ago · official registry · v0.1.0

FAQ

›How do I install the WhatsApp MCP server in Claude Code?

Run: claude mcp add jina-whatsapp -e META_ACCESS_TOKEN='<meta-access-token>' -e META_WABA_ID='<meta-waba-id>' -e META_PHONE_NUMBER_ID='<meta-phone-number-id>' -- uvx jina-whatsapp-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does WhatsApp require an API key?

Yes. It expects META_ACCESS_TOKEN, META_WABA_ID, META_PHONE_NUMBER_ID, of which 1 is a secret.

›Can I use WhatsApp as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is WhatsApp in the official MCP registry?

Yes, as io.github.nakulben/whatsapp-mcp.