MCP WhatsApp Cloud
概要
作者による説明(英語の原文)
MCP server for WhatsApp Cloud API (Meta) — messages, media, and templates via Graph API
PopNx MCPの3つの柱
この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。
- 利用者の声iレビューはまだありませんレビューは今後のステップで、アカウント機能と一緒に始まります
- 私たちの基本チェックi3項目中3項目に合格公開情報からチェック。コードはまだスキャンしていません
- 利用状況i初期↓ 63/週 · ★ 277
できること
このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。
- 接続方法: パソコンで動く
- トランスポート: stdio
- カテゴリ: チャット・メール
- 入力が必要なもの:WHATSAPP_ACCESS_TOKEN, WHATSAPP_PHONE_NUMBER_ID, WHATSAPP_BUSINESS_ACCOUNT_ID
インストール
使っているAIアプリを選んで、設定をコピーしてください。
インストールの前に
- 基本チェック:3項目中3項目に合格
- あなたのパソコンで、あなたのユーザーと同じ権限(ファイル、ネットワーク、アプリ)で動きます。
- 自分で入力するもの:
WHATSAPP_ACCESS_TOKEN,WHATSAPP_PHONE_NUMBER_ID,WHATSAPP_BUSINESS_ACCOUNT_ID,WHATSAPP_GRAPH_VERSION
「秘密」と表示された値は、あなたのアカウントの鍵です。絶対に人に教えたり、チャットに貼り付けたりしないでください。
必要なもの
どのアプリを使っていますか?
上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。
Claude Desktop → Settings → Developer → Edit Config を開き、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"
}
}
}
}ターミナルでこれを実行します
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動かす前に、空欄の値を入力してください。
または、設定を自分でコピーする
プロジェクトの .cursor/mcp.json、または ~/.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"
}
}
}
}ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。
または、設定を自分でコピーする
プロジェクトの .vscode/mcp.json に貼り付けます
{
"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"
}
}
}
}ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。
これはパソコンで動くサーバーですが、ChatGPTがつなげるのはインターネット上のサーバーだけです。ほかのアプリを選んでください。
選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。
自分で入力する値
- Meta system-user access token (permanent). Used as Bearer token for Graph API.
- WhatsApp Business phone number ID registered with Meta.
- WhatsApp Business Account (WABA) ID. Used for template management.
WHATSAPP_GRAPH_VERSIONenvGraph API version. Defaults to v21.0. Meta bumps quarterly.
この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
使えるアプリ
このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。
パソコン上で動かせるアプリ
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
できること
パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。
基本チェックi
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月11日にチェック
- ✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント codespar で確認済みです
- ✓ 合格
今もメンテナンスされている
コードの最終更新:44 日前
- ✓ 合格
ライセンスがある
MITを使用
- – 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
- – 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
- … 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです
チャット・メールのほかのサーバーとの比較i
- このカテゴリのほかの1932件のうち99%よりスターが多い
- このカテゴリのほかの1932件のうち13%より最近レジストリに公開
- 基本チェックの結果が、このカテゴリのほかの1932件のうち100%と同じかそれ以上
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
よくある質問
MCP WhatsApp Cloudは安全ですか?
当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
どんなキーやコードが必要ですか?
入力が必要なもの:WHATSAPP_ACCESS_TOKEN, WHATSAPP_PHONE_NUMBER_ID, WHATSAPP_BUSINESS_ACCOUNT_ID
パソコンで動きますか、それともクラウドですか?
あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。
今もメンテナンスされていますか?
GitHubリポジトリの最終更新は44 日前、最新バージョン(0.2.2)がレジストリに届いたのは5 か月前です。
どのアプリで使えますか?
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。
代わりに使えるものは?
同じカテゴリには:Inbox Zero, Agent-Native Mail, Agent-Native Dispatch
代わりの候補
同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。
カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
Agent-Native Mail
Agent-Native Superhuman - email client with keyboard shortcuts and AI triage
Agent-Native Dispatch
Central Slack/Telegram router with jobs, memory, approvals, and A2A delegation
作者のREADME
READMEを開く
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
@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_messagewith 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
linktosend_media_message. Fastest, but Meta fetches on every send. - Uploaded media_id — call
upload_mediaonce, reuseidon 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