Whatsapp Business MCP server

Connect Whatsapp Business to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Whatsapp Business MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the send template message tool in Whatsapp Business
  • Use the delete template tool in Whatsapp Business
  • Use the create template tool in Whatsapp Business
  • Use the send message tool in Whatsapp Business
  • Use the register phone number tool in Whatsapp Business
  • Use the update business profile tool in Whatsapp Business

Supported Tools

send_template_message

Send Template Message

Send a pre-approved WhatsApp message template to a recipient. Templates can be sent **outside the 24-hour messaging window** and are required for business-initiated conversations. Templates must be created and approved in the Meta dashboard before use. Use the List Templates tool to find available templates.

delete_template

Delete Template

Delete a WhatsApp message template by name. Without a template ID this deletes the template and **all its language translations**; with a template ID it deletes only that language version.

create_template

Create Template

Create a new WhatsApp message template. Templates must be approved by Meta before use. Most templates are reviewed by a machine learning process and approved in minutes; some may take up to 48 hours. Templates have three categories: **MARKETING**, **UTILITY**, and **AUTHENTICATION**.

send_message

Send Message

Send a WhatsApp message to a recipient. Supports multiple message types: **text**, **image**, **video**, **audio**, **document**, **location**, **contacts**, **sticker**, and **reaction**. For text messages within the 24-hour customer service window, use this tool. For messages outside the window, use the Send Template Message tool instead.

register_phone_number

Register Phone Number

Register a phone number for use with the WhatsApp Business Platform. Requires a 6-digit two-step verification PIN.

update_business_profile

Update Business Profile

Update the WhatsApp Business profile for your phone number. Only the fields you provide will be updated; omitted fields remain unchanged.

list_templates

List Templates

List message templates in your WhatsApp Business Account. Returns template IDs, names, statuses, categories, languages, parameter formats, rejection reasons, and component definitions. Filter by name, status, category, or language, and use pagination to browse through large template libraries.

get_business_profile

Get Business Profile

Retrieve the WhatsApp Business profile information for your phone number, including description, address, email, websites, industry vertical, and profile picture.

send_interactive_message

Send Interactive Message

Send an interactive WhatsApp message with **reply buttons**, a **list menu**, or a **call-to-action URL button**. Reply buttons allow up to 3 quick-reply options. List menus show up to 10 rows grouped into up to 10 sections. A call-to-action URL button opens a link in the recipient's browser. Use these for structured user responses like surveys, menu selections, or quick actions.

get_phone_number

Get Phone Number

Get details of a specific phone number registered with your WhatsApp Business Account.

list_phone_numbers

List Phone Numbers

List all phone numbers associated with your WhatsApp Business Account, including their verified names, display numbers, quality ratings, and verification status.

mark_message_read

Mark Message as Read

Mark an incoming WhatsApp message as read. This sends a read receipt (blue checkmarks) to the sender and also marks earlier messages in the conversation as read. Optionally shows a typing indicator while you prepare a reply.

delete_media

Delete Media

Delete a media file from WhatsApp servers by its media ID.

get_media_url

Get Media URL

Retrieve a WhatsApp media file by its media ID and provide it as a downloadable file, along with its MIME type, size, and SHA256 hash. Use this to access media files received from incoming messages (media IDs from incoming messages stay valid for 7 days; uploaded media for 30 days).

update_template

Update Template

Edit an existing WhatsApp message template by its template ID, for example to fix a rejected template and resubmit it for review. The provided components **replace all** existing components; the edited template goes back through Meta review.

Connect Whatsapp Business to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Whatsapp Business in Metorial. In your Metorial portal, enable the Whatsapp Business MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Whatsapp Business tools.

Run Whatsapp Business through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Whatsapp Business and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Whatsapp Business tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Whatsapp Business

Slack

Slack: connect with bot OAuth or user OAuth to work with messages, conversations, search, files, Canvases, Lists, profiles, reactions, reminders, and workspace productivity settings.

Salesforce

Manage CRM data including Accounts, Contacts, Leads, Opportunities, Cases, and custom objects. Create, read, update, and delete records. Query data using SOQL and search across objects using SOSL. Perform bulk data operations for large-scale imports, exports, and migrations. Execute composite requests to batch multiple operations in a single API call. Access analytics, reports, and dashboards. Manage files and attachments associated with records. Interact with Chatter feeds, posts, and groups for social collaboration. Manage org metadata including custom objects, fields, layouts, and workflows. Query data using GraphQL for precise data retrieval across related objects.

Apolloio

Search and prospect B2B contacts and companies from a database of over 275 million people and 70 million organizations. Enrich people and company data with emails, phone numbers, and firmographic details. Create and manage contacts, accounts, deals, and tasks. Add contacts to email sequences and manage sequence statuses. Log and search call records. Perform bulk operations for contact creation, account creation, task creation, and data enrichment.

Sharepoint

Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Resolve site users to numeric Person/Group LookupId values. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Retrieve site properties and search for sites across Microsoft 365.

Microsoft Outlook

Send, read, reply to, forward, and manage email messages in user mailboxes. Organize messages into folders, apply categories, flags, and importance levels. Manage file and item attachments. Create, update, delete, and respond to calendar events and meetings. Find available meeting times, manage attendees, handle recurrence, and work with shared or delegated calendars. Create, read, update, and delete contacts, organize them into contact folders, and manage contact photos. Manage tasks and task lists via Microsoft To Do, including due dates, reminders, recurrence, and checklist items. Subscribe to webhook notifications for changes to messages, calendar events, and contacts. Support for Focused Inbox, @-mentions, mail tips, send-on-behalf, and send-as capabilities.

Hubspot

Create, read, update, and delete CRM objects including contacts, companies, deals, tickets, and custom objects. Manage associations between CRM records. Track engagements such as calls, emails, meetings, notes, and tasks. Send transactional and marketing emails, manage campaigns, and handle subscription preferences. Build and manage marketing workflows, sequences, and automation actions. Manage CMS content including blog posts, landing pages, and HubDB tables. Handle commerce data including products, orders, invoices, quotes, and payments. Create and manage contact lists for segmentation. Configure deal, ticket, and order pipelines with custom stages. Search and filter CRM records. Bulk import and export CRM data. Manage users, teams, and account settings.

Technical notes for Whatsapp Business

Send and receive WhatsApp messages at scale, including text, images, audio, video, documents, locations, contacts, and interactive elements (buttons, lists). Manage and send pre-approved message templates for marketing, utility, and authentication purposes. Upload and download media files for use in messages. Retrieve and update WhatsApp Business profile information. Register and manage business phone numbers. Create interactive WhatsApp Flows for sign-ups, surveys, and lead capture. Monitor inbound messages, outbound message statuses, and account events via webhooks.

Frequently asked questions

Common questions about connecting Whatsapp Business to AI agents with Metorial.

  1. How many tools does the Whatsapp Business MCP server have?
    The Whatsapp Business MCP server exposes 15 tools, including Send Template Message, Delete Template, Create Template. Each one is governed and traced through Metorial.
  2. Whatsapp Business exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Whatsapp Business MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Whatsapp Business and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Whatsapp Business MCP server yourself or use the hosted gateway.

Connect Whatsapp Business to production AI agents

See how Metorial gives your team governed access to Whatsapp Business, with tracing and security controls built in.