MCP WhatsApp Cloud

Name: MCP WhatsApp Cloud
Author: codespar

by codesparversion 0.2.2i★ 277iRuns on your computer

Registry nameio.github.codespar/mcp-whatsapp-cloud

Overview

Description from the maker (original English)

MCP server for WhatsApp Cloud API (Meta) — messages, media, and templates via Graph API

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi3 of 3 passedChecked from public information; code not scanned yet
UsageiEarly★ 277

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs on your computer
Transport: stdio
Category: Chat & email
You need to fill in: WHATSAPP_ACCESS_TOKEN, WHATSAPP_PHONE_NUMBER_ID, WHATSAPP_BUSINESS_ACCOUNT_ID

Install

Pick the AI app you use, then copy the settings.

You need

npmNode.js installed (for the npx command)

Claude DesktopClaude CodeCursorVS Code

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "whatsapp-cloud": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-whatsapp-cloud"
      ],
      "env": {
        "WHATSAPP_ACCESS_TOKEN": "your-value",
        "WHATSAPP_PHONE_NUMBER_ID": "your-value",
        "WHATSAPP_BUSINESS_ACCOUNT_ID": "your-value",
        "WHATSAPP_GRAPH_VERSION": "your-value"
      }
    }
  }
}

Run this in your terminal

claude mcp add whatsapp-cloud --env WHATSAPP_ACCESS_TOKEN=your-value --env WHATSAPP_PHONE_NUMBER_ID=your-value --env WHATSAPP_BUSINESS_ACCOUNT_ID=your-value --env WHATSAPP_GRAPH_VERSION=your-value -- npx -y @codespar/mcp-whatsapp-cloud

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "whatsapp-cloud": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-whatsapp-cloud"
      ],
      "env": {
        "WHATSAPP_ACCESS_TOKEN": "your-value",
        "WHATSAPP_PHONE_NUMBER_ID": "your-value",
        "WHATSAPP_BUSINESS_ACCOUNT_ID": "your-value",
        "WHATSAPP_GRAPH_VERSION": "your-value"
      }
    }
  }
}

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "whatsapp-cloud": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-whatsapp-cloud"
      ],
      "env": {
        "WHATSAPP_ACCESS_TOKEN": "your-value",
        "WHATSAPP_PHONE_NUMBER_ID": "your-value",
        "WHATSAPP_BUSINESS_ACCOUNT_ID": "your-value",
        "WHATSAPP_GRAPH_VERSION": "your-value"
      }
    }
  }
}

Values you fill in

WHATSAPP_ACCESS_TOKEN secret required env
Meta system-user access token (permanent). Used as Bearer token for Graph API.
WHATSAPP_PHONE_NUMBER_ID required env
WhatsApp Business phone number ID registered with Meta.
WHATSAPP_BUSINESS_ACCOUNT_ID required env
WhatsApp Business Account (WABA) ID. Used for template management.
WHATSAPP_GRAPH_VERSION env
Graph API version. Defaults to v21.0. Meta bumps quarterly.

Values marked secret are keys to your account. Never share them or paste them into a chat.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 5, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account codespar, which owns the repo
✓ Pass
Still maintained
Code last changed 39 days ago
✓ Pass
Has a licence
Uses MIT
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Needs the server’s tool list first; this check starts in the next step

Compared with others in Chat & emaili

More stars than 67% of the other 6 servers in this category
Published to the registry more recently than 17% of the other 6 servers in this category
Basic checks equal to or better than 100% of the other 6 servers in this category

Compared only with servers in this prototype, not the whole registry.

Common questions

Is MCP WhatsApp Cloud safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: WHATSAPP_ACCESS_TOKEN, WHATSAPP_PHONE_NUMBER_ID, WHATSAPP_BUSINESS_ACCOUNT_ID

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed 39 days ago, and the latest version (0.2.2) reached the registry 5 months ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.

What can I use instead?

In the same category: Vexa, emailmd, Gmail MCP Server

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Vexa

by Vexa-ai

Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.

Runs in the cloud★ 2,949Apache-2.0Updated 2 months ago

emailmd

by anypost

Render markdown into email-safe HTML, lint drafts for deliverability problems, and preview emails.

Computer or cloud★ 1,385MITUpdated 30 days ago

Gmail MCP Server

by ArtyMcLabin

Lets AI read, search and draft emails in your Gmail, signed in with your Google account through a local settings file.

Runs on your computer★ 255MITUpdated 4 days ago

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

@codespar/mcp-whatsapp-cloud

MCP server for the WhatsApp Cloud API — Meta's official WhatsApp Business API, self-hosted on Meta infrastructure.

Direct Meta integration. No middleman, no provider markup. For merchants with an approved WhatsApp Business Account (WABA) who want Meta-direct pricing and full control over conversation, pricing category, and template lifecycle.

WhatsApp servers in this catalog

Server	What it is	When to pick it
whatsapp-cloud (this)	Direct Meta Cloud API	Large merchants with approved WABA; lower cost at scale, no intermediary fees
z-api	Wrapper on top of Meta Cloud	Easy onboarding, instant QR-pair, extra helpers
evolution-api	Open-source wrapper	Self-hosted, community-driven
take-blip	Brazilian BSP wrapper	Enterprise Brazil, CCaaS features
zenvia	Brazilian BSP wrapper	Brazil omnichannel (SMS + WhatsApp)

Tools (22)

Tool	Purpose
`send_text_message`	Send a plain text message.
`send_template_message`	Send an approved message template.
`send_media_message`	Send an image, video, document, or audio.
`send_interactive_message`	Send an interactive message (reply buttons or list).
`send_interactive_cta_url`	Send an interactive message with a single CTA URL button.
`send_interactive_flow`	Send a WhatsApp Flow message.
`send_location_message`	Send a location pin with latitude/longitude and optional name/address.
`send_contacts_message`	Send one or more contact cards (vCard-like).
`send_reaction_message`	Send an emoji reaction on a previously received/sent message.
`send_typing_indicator`	Show a typing indicator on a received message.
`mark_message_as_read`	Mark an incoming message as read so the sender sees the blue double-check.
`upload_media`	Upload a media file and get back a media_id reusable in send_media_message.
`retrieve_media_url`	Resolve a media_id to a short-lived downloadable URL.
`delete_media`	Delete an uploaded media asset by id.
`list_templates`	List message templates on the WhatsApp Business Account.
`create_template`	Submit a new template for Meta review.
`delete_template`	Delete a message template from the WABA by name.
`get_business_profile`	Read the WhatsApp business profile (about, description, email, websites, vertical, address) for the configu...
`update_business_profile`	Update the business profile on the configured phone number.
`list_phone_numbers`	List all phone numbers registered under the WhatsApp Business Account, including display name, quality rati...
`request_verification_code`	Request Meta to send a verification code to the configured phone number via SMS or voice.
`verify_code`	Submit the verification code received via SMS/voice after request_verification_code.

Install

npm install @codespar/mcp-whatsapp-cloud

Environment

WHATSAPP_ACCESS_TOKEN="EAAG..."           # required (secret) — Meta system-user token

WHATSAPP_PHONE_NUMBER_ID="1234567890" # required — WABA phone number id WHATSAPP_BUSINESS_ACCOUNT_ID="9876543210" # required — WABA id (for templates) WHATSAPP_GRAPH_VERSION="v21.0" # optional — Meta bumps quarterly

Authentication

Bearer token against the Graph API. Use a permanent system-user token from Meta Business Manager — user access tokens expire and will break production.

Authorization: Bearer <WHATSAPP_ACCESS_TOKEN>

Messaging rules (important)

Customer-service window — You can freely send any message type for 24h after the user last messaged you.
Business-initiated — Outside that window you must send an approved template. Use send_template_message with a name + language + components.
Templates — Create with create_template, wait for Meta approval (minutes to hours), then use.
Phone numbers are E.164 without the leading `+` (e.g. 5511999999999).

Media

Two paths:

Public URL — pass link to send_media_message. Fastest, but Meta fetches on every send.
Uploaded media_id — call upload_media once, reuse id on subsequent sends. Recommended for catalog assets.

Uploaded media expires after ~30 days.

Interactive messages

send_interactive_message expects a fully-formed interactive object. Example button payload:

"type": "button", "body": { "text": "Confirma seu pedido?" }, "action": { "buttons": [ { "type": "reply", "reply": { "id": "confirm", "title": "Confirmar" } }, { "type": "reply", "reply": { "id": "cancel", "title": "Cancelar" } } ] } }

See the Cloud API interactive reference for list payloads.

Run

# stdio (default — for Claude Desktop, Cursor, etc)

npx @codespar/mcp-whatsapp-cloud

HTTP (for server-to-server)

MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-whatsapp-cloud

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT

MCP WhatsApp Cloud

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Values you fill in

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Chat & emaili

Common questions

Alternatives

Vexa

emailmd

Gmail MCP Server

README from the maker

@codespar/mcp-whatsapp-cloud

WhatsApp servers in this catalog

Tools (22)

Install

Environment

Authentication

Messaging rules (important)

Media

Interactive messages

Run

HTTP (for server-to-server)

Enterprise

License