WhatsApp Cloud

What your agent can do

WhatsApp Cloud gives your agent 22 tools it calls directly — pick the ones it needs, in Claude, Cursor, or any MCP client.

• →send_text_message — Send a plain text message. For business-initiated conversations outside the 24h customer-service window, use send_template_message instead.
• →send_template_message — Send an approved message template. Required for business-initiated conversations. Templates must be pre-approved by Meta via create_template.
• →send_media_message — Send an image, video, document, or audio. Supply either `link` (public URL) or `id` (media_id from upload_media).

// Your agent calls a tool directly — no glue code.
// CodeSpar's managed tier handles OAuth2, token rotation and rate limits.
const result = await session.call("send_text_message", { /* ... */ });

Install

$ npm install @codespar/mcp-whatsapp-cloud

Quickstart

Add this entry to your claude_desktop_config.json (or any MCP-compatible client config).

{
  "mcpServers": {
    "whatsapp-cloud": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-whatsapp-cloud"
      ],
      "env": {
        "WHATSAPP_ACCESS_TOKEN": "<your_whatsapp_access_token>",
        "WHATSAPP_PHONE_NUMBER_ID": "<your_whatsapp_phone_number_id>",
        "WHATSAPP_BUSINESS_ACCOUNT_ID": "<your_whatsapp_business_account_id>"
      }
    }
  }
}

After restart, your agent can call any of the 22 tools below — try send_text_message first.

Environment variables · 4

Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.

Available tools · 22

Each tool is independent — your agent loads only what it needs to reduce context and response time.

Compatible frameworks

MCP is a protocol — any framework that speaks it can mount this server.

Frequently asked questions