Meta Cloud API MCP Server

<p align="center"> <img src="assets/README.svg" alt="Meta Cloud API" width="400"> </p>

<h1 align="center">Meta Cloud API MCP Server</h1>

<p align="center"> A Model Context Protocol (MCP) server that lets Claude manage WhatsApp templates, flows, and send messages through the WhatsApp Cloud API. </p>

<p align="center"> <a href="https://www.npmjs.com/package/meta-cloud-api-mcp"><img src="https://img.shields.io/npm/v/meta-cloud-api-mcp.svg" alt="npm version"></a> <a href="https://www.npmjs.com/package/meta-cloud-api"><img src="https://img.shields.io/badge/SDK-meta--cloud--api-blue" alt="SDK"></a> <a href="https://modelcontextprotocol.io"><img src="https://img.shields.io/badge/MCP-compatible-brightgreen" alt="MCP Compatible"></a> <a href="https://github.com/froggy1014/meta-cloud-api-mcp/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License"></a> </p>

---

What is this?

This MCP server wraps the meta-cloud-api SDK, giving Claude (and other MCP-compatible clients) direct access to the WhatsApp Business Platform. You can ask Claude to:

• "Create a welcome template in English and Spanish"
• "List all my flows and publish the draft one"
• "Send a template message to +1-555-123-4567"
• "Update my business profile description"

Quick Start

1. Install

npm install -g meta-cloud-api-mcp

2. Get Your Credentials

You need three values from the Meta Developer Portal:

| Variable | Where to find it | |----------|-----------------| | CLOUD_API_ACCESS_TOKEN | App Dashboard > WhatsApp > API Setup | | WA_PHONE_NUMBER_ID | App Dashboard > WhatsApp > API Setup > Phone number ID | | WA_BUSINESS_ACCOUNT_ID | App Dashboard > WhatsApp > API Setup > WhatsApp Business Account ID |

3. Configure Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "whatsapp": {
      "command": "npx",
      "args": ["-y", "meta-cloud-api-mcp"],
      "env": {
        "CLOUD_API_ACCESS_TOKEN": "your_access_token",
        "WA_PHONE_NUMBER_ID": "your_phone_number_id",
        "WA_BUSINESS_ACCOUNT_ID": "your_business_account_id"
      }
    }
  }
}

4. Configure Claude Code

claude mcp add whatsapp -- npx -y meta-cloud-api-mcp

# Then set environment variables in your .claude/settings.json

Available Tools (31)

Templates (5 tools)

| Tool | Description | |------|-------------| | list_templates | List templates with filters (name, status, category, language) | | get_template | Get a single template by ID with full component definition | | create_template | Create a new message template (MARKETING, UTILITY, AUTHENTICATION) | | update_template | Update template components (resubmits for review) | | delete_template | Delete a template by name or specific language version |

Flows (8 tools)

| Tool | Description | |------|-------------| | list_flows | List all flows for your WhatsApp Business Account | | get_flow | Get flow details including status and validation errors | | create_flow | Create a new flow (optionally with inline JSON or clone) | | update_flow_metadata | Update flow name, categories, or endpoint URI | | update_flow_json | Upload or update the flow JSON definition | | delete_flow | Delete a draft flow | | publish_flow | Publish a draft flow (makes it live) | | deprecate_flow | Deprecate a published flow (irreversible) |

Messages (3 tools)

| Tool | Description | |------|-------------| | send_text_message | Send a text message to a phone number | | send_template_message | Send a pre-approved template message | | send_image_message | Send an image (by media ID or public URL) |

Media (4 tools)

| Tool | Description | |------|-------------| | get_media_info | Get media metadata (URL, MIME type, size, hash) | | upload_media | Upload a file to WhatsApp (returns media ID) | | delete_media | Delete media from WhatsApp servers | | download_media | Download media content to a local file |

Business Profile (2 tools)

| Tool | Description | |------|-------------| | get_business_profile | Get profile (about, address, email, websites, etc.) | | update_business_profile | Update profile fields |

WABA (3 tools)

| Tool | Description | |------|-------------| | get_waba_account | Get account info (status, health, verification, limits) | | subscribe_waba_webhook | Subscribe to WABA webhooks with optional callback override | | unsubscribe_waba_webhook | Unsubscribe from WABA webhooks |

Phone Numbers (4 tools)

| Tool | Description | |------|-------------| | get_phone_number | Get phone number info (display number, quality, status) | | list_phone_numbers | List all phone numbers in the WABA | | request_verification_code | Request verification code via SMS or voice | | verify_phone_code | Verify phone number with received code |

Registration (2 tools)

| Tool | Description | |------|-------------| | register_phone | Register a phone number with a 6-digit PIN | | deregister_phone | Deregister a phone number |

Example Conversations

Managing Templates: > "List all my approved marketing templates" > > "Create a template called order_update with a body that says 'Your order has been confirmed. Order number: {{1}}'" > > "Delete the old_promo template"

Managing Flows: > "Show me all my flows and their statuses" > > "Create a new customer support flow called support_v2" > > "Update the flow JSON for flow ID 12345 with this definition: { ... }" > > "Publish flow 12345"

Sending Messages: > "Send 'Hello!' to +15551234567" > > "Send the hello_world template in English to +15551234567"

Development

git clone https://github.com/froggy1014/meta-cloud-api-mcp.git
cd meta-cloud-api-mcp
npm install
npm run build

Testing with MCP Inspector

npx @modelcontextprotocol/inspector node dist/index.js

Set environment variables in the Inspector UI, then browse and test all 31 tools interactively.

Requirements

• Node.js 18 or later
• Meta Developer Account with WhatsApp Business API access
• MCP-compatible client (Claude Desktop, Claude Code, etc.)

Related

• meta-cloud-api — The TypeScript SDK this server wraps
• meta-cloud-api docs — SDK documentation
• Model Context Protocol — MCP specification
• WhatsApp Cloud API — Official Meta documentation

License

MIT - see LICENSE for details.