otheroauth2

WhatsApp

Enables interaction with customers through the WhatsApp Business API for messaging and automation. Only supports WhatsApp Business accounts, not WhatsApp Personal accounts.

Verdict

The WhatsApp MCP lets your team send business messages, manage templates, and retrieve media through WhatsApp Business API. @mention it to create or delete message templates (required for marketing messages and outreach beyond the 24-hour customer service window), fetch business profile details, download media files, and list phone numbers tied to your WhatsApp Business Account. Most useful for support teams handling customer inquiries, marketing teams scheduling template-based campaigns, and operations teams auditing message activity. OAuth setup requires a WhatsApp Business Account with API access — not available for standard WhatsApp accounts.

Common use cases

  • Send templated marketing messages at scale
  • Download customer-uploaded media from support chats
  • Audit active phone numbers across business accounts
  • Create pre-approved templates for campaign launches
  • Retrieve business profile details for compliance checks

Integration

Vendor
WhatsApp
Category
other
Auth
OAUTH2
Tools
19
Composio slug
whatsapp

Tools

  • Create message template

    Create a new message template for the whatsapp business account. templates must be approved by whatsapp before they can be used. templates are required for marketing messages and messages sent outside the 24-hour window.

  • Delete message template
    destructive

    Delete a message template from the whatsapp business account. this permanently removes the template and it cannot be recovered. only delete templates that are no longer needed.

  • Get business profile

    Get the business profile information for a whatsapp business phone number. this includes business details like description, address, website, and contact info.

  • Get media

    Get information about uploaded media including a temporary download url. the download url is valid for 5 minutes and can be used to retrieve the actual media file. this is useful for downloading media that was sent to your whatsapp number.

  • Get media info

    Get metadata about uploaded media without generating a download url. this is useful for checking file size, type, and hash without downloading the file. use get media if you need the actual download url.

  • Get message templates

    Get all message templates for the whatsapp business account. templates are required for sending messages outside the 24-hour window and for marketing/utility messages.

  • Get phone number

    Get details of a specific phone number associated with a whatsapp business account.

  • Get phone numbers

    Get all phone numbers associated with a whatsapp business account (waba).

  • Get template status

    Get the status and details of a specific message template. this is useful for checking if a template has been approved, rejected, or is still pending review.

  • Send contacts

    Send contacts whatsapp number. note: the message will be delivered to the recipient only if they have initiated a conversation first.

  • Send interactive buttons

    Send an interactive button message to a whatsapp number. button messages allow users to quickly respond by tapping up to 3 predefined buttons. perfect for yes/no questions, quick choices, or call-to-action scenarios. note: the message will

  • Send interactive list

    Send an interactive list message to a whatsapp number. list messages allow users to select from up to 10 options in a structured format. great for menus, catalogs, or choices. note: the message will be delivered to the recipient only if the

  • Send location

    Send a location message to a whatsapp number. note: the location will be shared with the recipient only if they have texted first.

  • Send media

    Send a media message to a whatsapp number. note: the media will be delivered to the recipient only if they have texted first.

  • Send media by

    Send media using a media id from previously uploaded media. this is more efficient than sending media by url as the media is already on whatsapp servers. use upload media action first to get the media id. note: the media will be delivered t

  • Send message

    Send a text message to a whatsapp number. note: the message will reflect on the recipient's phone number only if they have texted first.

  • Send reply

    Send a reply to a specific message in a whatsapp conversation. this creates a contextual reply that shows which message you're responding to. note: the reply will be delivered to the recipient only if they have texted first.

  • Send template message

    Send a template message to a whatsapp number.

  • Upload media

    Upload media files (images, videos, audio, documents, stickers) to whatsapp servers. the uploaded media gets a media id that can be used in send media or other messaging actions. supported formats: - images: jpeg, png (max 5mb) - videos: mp

Setup

Setup guide

  1. 11. In Switchy, open Settings > Integrations and click Connect next to WhatsApp. 2. You'll be redirected to Meta's OAuth screen — sign in with the Facebook account that manages your WhatsApp Business Account. 3. Grant permissions for 'whatsapp_business_management' and 'whatsapp_business_messaging' scopes (these let Switchy read templates, send messages, and access media). 4. After authorizing, you'll return to Switchy where the connection status shows 'Connected'. 5. Open any Project, type '@WhatsApp get message templates' in the chat, and hit send — if you see a list of your templates (or an empty array if none exist), the integration works. 6. To invoke other tools, @mention WhatsApp followed by your request (e.g. '@WhatsApp get business profile for phone number +1234567890').

What teammates see: by default, memories from WhatsApp are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Projects have used this MCP together with a given model.

How Switchy teams use it

Not enough Projects yet to publish anonymised usage stats (we require ≥ 50 Projects per week).

Starter prompts

List All Templates

@WhatsApp get message templates for my account and show me the template names, statuses, and categories in a table
Open in a Project →

Fetch Business Profile

@WhatsApp get business profile for phone number [insert your WhatsApp Business number] and summarize the description, website, and contact info
Open in a Project →

Download Recent Media

@WhatsApp get media info for media ID [insert media ID from a recent message] then get the download URL so I can save the file
Open in a Project →

Create Campaign Template

@WhatsApp create message template named 'spring_sale_2024' with category MARKETING, language en_US, and body text 'Hi {{1}}, our spring sale starts tomorrow—save 20% on all items!'
Open in a Project →

Audit Phone Numbers

@WhatsApp get phone numbers for my WhatsApp Business Account and show me the display names, verified status, and quality ratings
Open in a Project →

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@WhatsApp list all message templates for our business account and show which ones are approved

Output

Here are the message templates for your WhatsApp Business account: **Approved Templates:** • order_confirmation (Marketing) - "Hi {{1}}, your order #{{2}} has been confirmed!" • appointment_reminder (Utility) - "Reminder: Your appointment is scheduled for {{1}} at {{2}}" **Pending Review:** • new_product_launch (Marketing) - Submitted 2 days ago **Rejected:** • flash_sale (Marketing) - Reason: Contains promotional language that violates policy You can use approved templates immediately. Pending templates typically take 24-48 hours for WhatsApp review.

Notes

This example shows the MCP's ability to retrieve and organize template status. Remember that templates must be pre-approved by WhatsApp before use—you cannot send marketing messages or messages outside the 24-hour customer service window without an approved template. The approval process is outside Switchy's control and can take 1-2 business days.

Prompt

@WhatsApp create a new appointment reminder template that asks customers to confirm their booking 24 hours in advance

Output

I've submitted a new message template to WhatsApp for approval: **Template Name:** appointment_confirm_24h **Category:** Utility **Language:** English **Content:** "Hi {{1}}, this is a reminder that you have an appointment scheduled for {{2}} at {{3}}. Please reply YES to confirm or CANCEL to reschedule." **Status:** Pending Review **Next Steps:** • WhatsApp typically reviews utility templates within 24 hours • You'll receive a notification once approved or if changes are needed • Cannot use this template until approval is granted • Variables {{1}}, {{2}}, {{3}} will be replaced with customer name, date, and time when sending

Notes

This demonstrates template creation, which is a write action that triggers WhatsApp's approval workflow. The template won't be usable immediately—it enters a review queue. Utility templates (like appointment reminders) typically get faster approval than marketing templates. The MCP requires proper OAuth2 scopes to create templates, and your WhatsApp Business Account must be verified.

Prompt

@WhatsApp check our business profile settings and suggest improvements to increase customer trust

Output

I've retrieved your WhatsApp Business profile. Here's what I found: **Current Profile:** • Business Name: Acme Consulting • Description: (empty) • Address: 123 Main St, Austin, TX • Website: Not set • Email: support@acme.com • Vertical: Professional Services **Recommendations to Increase Trust:** 1. **Add a description** - 78% of customers check this first. Suggest: "Strategic consulting for growing tech companies. Serving Austin since 2019." 2. **Set your website URL** - Builds credibility and provides an easy way for customers to learn more 3. **Add business hours** - Currently not configured; customers don't know when to expect responses 4. **Consider adding a profile photo** - Verified businesses with photos see 40% higher engagement Would you like me to help draft profile updates?

Notes

This example pairs WhatsApp's profile data retrieval with AI reasoning to provide actionable recommendations. The MCP fetches raw profile fields; the AI analyzes completeness and suggests improvements based on best practices. Note that profile changes through the API may require additional verification steps depending on what fields you modify (business name changes, for instance, trigger re-verification).

Use-case deep-dives

Customer support template library

When WhatsApp MCP makes sense for high-volume support teams

A 6-person support team handling 200+ daily inquiries across three time zones needs pre-approved templates for order updates, shipping confirmations, and refund status. The WhatsApp MCP is the right call here because OAuth2 keeps credentials out of individual agent hands, and the template management tools let the team lead audit and retire stale messages without touching the Business API console. The trade-off: templates require WhatsApp approval (usually 24-48 hours), so you can't spin up a new message flow on the fly. If your team sends fewer than 50 messages a day or needs real-time template iteration, the overhead isn't worth it. For teams at scale with stable message patterns, this MCP centralizes template governance and keeps the workspace audit trail clean.

Outbound campaign coordination

Why marketing teams hit the 24-hour window problem

A 3-person growth team running a product launch wants to send WhatsApp announcements to 1,200 opted-in users. The WhatsApp MCP handles template creation and retrieval, but the critical constraint is WhatsApp's 24-hour messaging window: you can only send marketing messages using pre-approved templates, and replies open a 24-hour window for freeform conversation. This MCP works if your campaign is template-driven and you've planned approval lead time. It doesn't work if you're trying to send personalized, one-off messages or react to user behavior in real time. The phone number and business profile tools help the team verify sender identity before launch, but the approval bottleneck means this is a scheduled-campaign play, not a conversational-marketing one. If your launch timeline is under a week, start the template approval process before you integrate.

Media asset handoff workflow

When the media tools solve a specific logistics problem

A 4-person content team sends weekly video tutorials to 300 customers via WhatsApp. The challenge: videos uploaded to WhatsApp expire after 30 days, and the team needs to track which assets are still live before scheduling sends. The WhatsApp MCP's media info and media retrieval tools let the team check file metadata and generate temporary download URLs without leaving Switchy, so they can audit the media library and re-upload expired files in one session. The 5-minute download URL window is tight, so this workflow assumes the team is doing batch checks, not ad-hoc downloads. If your team sends fewer than 10 media messages a month or doesn't need programmatic media audits, the native WhatsApp Business app is simpler. For teams managing a rotating media library at scale, this MCP turns media hygiene into a repeatable task.

Frequently asked

What can the WhatsApp MCP do in Switchy?

The WhatsApp MCP lets your team send templated messages, manage business profiles, and handle media uploads through WhatsApp Business API. It's built for teams running customer support or marketing campaigns that need programmatic access to WhatsApp without writing API code. You can create and delete message templates, retrieve media files, and check phone number details — all from Switchy's AI workspace.

Do I need a WhatsApp Business account to connect this?

Yes. You need an active WhatsApp Business API account (WABA), not just the free WhatsApp Business app. The MCP uses OAuth2, so you'll authenticate through Meta's flow and grant Switchy permission to manage templates, send messages, and access media on your behalf. Individual WhatsApp accounts won't work — this is for verified business accounts only.

Can it send messages to anyone, or only approved contacts?

It can only send templated messages that WhatsApp has pre-approved, and only to users who've opted in to hear from your business. You can't blast arbitrary text to random numbers. Marketing messages require approved templates; customer service replies work within a 24-hour window after the user messages you first. This is WhatsApp's policy, not a Switchy limitation.

Why use this instead of the WhatsApp Business app?

The app is manual and single-user. The MCP gives your whole team programmatic access — create templates in bulk, automate media retrieval, check message status across phone numbers — without logging into Meta Business Suite. If you're running campaigns or support workflows that need automation, the MCP saves hours. If you're just replying to a few customers a day, stick with the app.

Who on my team should connect the WhatsApp MCP?

Whoever owns your WhatsApp Business API account in Meta Business Manager. They need admin access to authenticate and grant Switchy the OAuth scopes. Once connected, any Switchy user with workspace access can invoke the tools — but template approval and phone number setup still happen in Meta's dashboard, not Switchy.

More other MCPs

See all other MCPs

Data last verified 7 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.