
WhatsApp Business MCP Server: Setup for Claude, ChatGPT and Codex
Lets Claude and ChatGPT manage your WhatsApp Business account: phone numbers, message templates, webhooks and test messages.
This is Meta's own hosted server for the WhatsApp Business Platform. You sign in with your Meta developer account, and it acts as you on the businesses and apps you administer. It is in beta, so the tool set may change.
Good for
- Developers building on the WhatsApp Business Platform (Cloud API)
- Teams that onboard and register business phone numbers
- Marketers who manage message templates
- Engineers who debug webhooks and account setup
Works in
14 should work
Tap an app to see how to set it up and any known problems.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Install WhatsApp Business Tools MCP
Claude Code
- 1
Copy this prompt.
Add the WhatsApp Business Tools MCP server to Claude Code. Run this command: claude mcp add --transport http whatsapp-business-tools https://mcp.facebook.com/whatsapp_business_tools Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires Sign-in with the vendor account (OAuth).
Built from the package data we hold. Not yet tested by us.
Tools
Lists the businesses you manage
Lists the businesses you administer and granted access to during sign-in. Start here, since most other tools work inside one business.
Try: “List the businesses I can manage on WhatsApp.”
Network ·
whatsapp_biz_businessesLists WhatsApp accounts under a business
Lists the WhatsApp accounts, including messaging accounts, that belong to a business.
Try: “Show the WhatsApp accounts for business 1234567890.”
Network ·
whatsapp_biz_accountsLists phone numbers with status
Lists the phone numbers on a business or WhatsApp account with their status and onboarding state.
Try: “List the phone numbers and their status for this business.”
Network ·
whatsapp_biz_phone_numbersLists message templates
Lists the message templates on a WhatsApp account.
Try: “List the approved templates for this account.”
Network ·
whatsapp_biz_list_templatesShows one message template
Shows the details of a single message template on an account.
Try: “Show me the order_update template.”
Network ·
whatsapp_biz_get_templateSends a WhatsApp message
Sends free-form text or an approved template from a registered number. Free-form text is only delivered inside the 24-hour customer service window. It confirms the target with you before sending.
Try: “Send the order_update template to +1 555 010 9999 from this number.”
Write ·
whatsapp_biz_send_messageCreates a message template
Creates a new message template on an account, such as a marketing template in a given language.
Try: “Create a marketing template named order_update in en_US.”
Write ·
whatsapp_biz_create_templateEdits a message template
Updates an existing message template.
Try: “Update the order_update template with the new wording.”
Write ·
whatsapp_biz_update_templateDeletes a message template
Deletes a message template from an account.
Try: “Delete the old_promo template.”
Delete ·
whatsapp_biz_delete_templateAdds a phone number to an account
Adds a phone number to a WhatsApp account. This is the first step of onboarding a number.
Try: “Add the phone number +1 555 010 1234 to my WhatsApp account.”
Write ·
whatsapp_biz_add_phone_numberSends a verification code to a number
Sends a verification code to a phone number you are onboarding.
Try: “Send a verification code by SMS to this number.”
Write ·
whatsapp_biz_send_verification_codeVerifies a number with its code
Verifies a phone number using the code that was sent to it.
Try: “Verify this number with code 123456.”
Write ·
whatsapp_biz_verify_phone_numberRegisters a verified number for messaging
Registers a verified number so it can send and receive messages.
Try: “Register this number for messaging.”
Write ·
whatsapp_biz_register_phone_numberSets your webhook address and fields
Sets the callback URL and verify token for the WhatsApp topic and subscribes the allowed fields.
Try: “Configure webhooks for this business with callback https://example.com/webhook.”
Write ·
whatsapp_biz_configure_webhooksSubscribes an account to your app webhooks
Subscribes a WhatsApp account to your app's webhooks so its events are delivered.
Try: “Subscribe this WhatsApp account to webhooks.”
Write ·
whatsapp_biz_subscribe_webhookSets up a payment method for billable messages
Configures a payment method so the account can send billable messages.
Try: “Help me set up payments for this account.”
Write ·
whatsapp_biz_configure_paymentsChecks and starts business verification
Checks your business verification status and starts verification.
Try: “What is the business verification status, and how do I start it?”
Write ·
whatsapp_biz_verify_businessLinks you to create a system user token
Returns a link to the System Users page in Business Settings. You generate the token there, so the tool never hands one over.
Try: “Give me a link to create a system user access token for this business.”
Read ·
whatsapp_biz_system_user_token
From the official docs
Permissions
high risk · 4 things to watch
High risk
It can message real people, delete templates and change webhook and payment settings on your business. Approve each action yourself, and use it only on accounts you are allowed to change.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
It can send real WhatsApp messages
The send tool messages real phone numbers from your registered number. Read the recipient and text before you approve each send. developers.facebook.com
It can delete templates and change webhooks
It can delete message templates and reset your webhook address. Check the template name and callback URL before you approve. developers.facebook.com
It can set up payment for billable messages
One tool configures a payment method on the account. Review what it asks before you agree. developers.facebook.com
It is in beta and may change
Meta says the interface and tool set may change. It is also rolling out gradually, so it may not be available to your account yet. developers.facebook.com
Security advisories
No published security advisories as of Nov 2, 2026.
Technical details
| Turning on read-only | No read-only mode is documented. |
|---|---|
| Talks to | Meta (mcp.facebook.com) |
| Sign-in and keys | Sign in with your Meta developer account. No client ID or Meta app setup is needed. You can revoke access under Settings, Your Activity, Business Integrations on Facebook. |
| Scopes |
|
Questions
What do I need before I connect?
You need admin access to a business, admin access to a WhatsApp-enabled app connected to it, and accepted WhatsApp Business Cloud API terms for that business. Without these, most tools return an error that says what to fix.
Which apps does it work with?
Meta lists Claude Code, Claude Desktop, ChatGPT, Codex CLI and the Codex app. Cursor is not on the list.
Can it send messages to customers?
Yes. Free-form text is delivered only inside the 24-hour customer service window. Outside it, you send an approved template. The tool asks you to confirm the target first.
What is the WhatsApp Business Tools MCP server URL?
It is https://mcp.facebook.com/whatsapp_business_tools. You sign in with your Meta developer account and need no client ID or redirect URI.
What permissions does it ask for?
It asks for three permissions: business_management, whatsapp_business_management and whatsapp_business_messaging. You can review and revoke them on Facebook under Settings, Your Activity, Business Integrations.
Is it stable?
Not yet. It is in beta, and Meta says the tool set may change.
Information
updated Nov 1, 2026
- Publisher
- Official
- Transport
- Streamable HTTP
- Auth
- OAuth
Other WhatsApp MCP servers
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 1Hide
- WhatsApp Business Tools MCP · developers.facebook.com