WhatsApp MCP Server

A comprehensive Model Context Protocol (MCP) server that enables seamless integration with WhatsApp Business API. Send messages, manage media, interact with templates, and access business profile information directly through your AI assistant or automation workflows.

Overview

The WhatsApp MCP Server provides a robust interface to WhatsApp's Business API, allowing you to programmatically send various types of messages, manage media files, and retrieve business account information. Whether you need to send simple text messages, rich media content, interactive buttons, or pre-approved templates, this server handles all the complexity of the WhatsApp API, presenting a clean and intuitive interface for automated messaging and customer engagement.

Key Features

This MCP server transforms how you interact with WhatsApp Business by providing:

• Multiple Message Types: Send text, media, location, contact cards, and interactive messages with buttons or lists
• Template Management: Access and send pre-approved message templates for compliance with WhatsApp's business messaging policies
• Media Handling: Upload, retrieve, and delete media files on WhatsApp's servers
• Interactive Messaging: Create engaging experiences with button-based replies and list selections
• Business Profile Access: Retrieve business profile information and phone number details
• Message Status Management: Mark messages as read to manage conversation states

Tools

send_text_message

Send a basic text message to any WhatsApp number. This is the simplest way to communicate with your contacts.

Parameters:

• recipient (required): Phone number in international format (e.g., +1234567890)
• text (required): The message content to send
• preview_url (optional): Boolean flag to enable URL preview in the message

send_template_message

Send pre-approved message templates that comply with WhatsApp's business messaging policies. Templates are particularly useful for notifications, alerts, and standardized communications.

Parameters:

• recipient (required): Phone number in international format
• template_name (required): Name of your approved template
• language_code (required): Language code such as 'en', 'en_US', 'es', etc.
• parameters (optional): Array of string values to fill template placeholders

send_media_message

Share rich media content including images, videos, audio files, and documents with your contacts.

Parameters:

• recipient (required): Phone number in international format
• media_type (required): One of: 'image', 'video', 'audio', or 'document'
• media_url (optional): Direct URL to the media file
• media_id (optional): Media ID from WhatsApp (alternative to URL)
• caption (optional): Text caption for images, videos, and documents
• filename (optional): Filename for document type messages

send_location_message

Share geographical locations with precise coordinates, perfect for directions, business locations, or meeting points.

Parameters:

• recipient (required): Phone number in international format
• latitude (required): Latitude coordinate as a number
• longitude (required): Longitude coordinate as a number
• name (optional): Name or title of the location
• address (optional): Street address or description of the location

send_contact_message

Send one or multiple contact cards, making it easy to share professional or personal contact information.

Parameters:

• recipient (required): Phone number in international format
• contacts (required): Array of contact objects, each containing:
  • name (required): Object with formatted_name (required), plus optional first_name and last_name
  • phones (optional): Array of phone objects with phone number and optional type (e.g., CELL, WORK)
  • emails (optional): Array of email objects with email address and optional type

send_interactive_buttons

Create engaging messages with up to three clickable buttons for quick responses and user interaction.

Parameters:

• recipient (required): Phone number in international format
• body_text (required): Main message content
• buttons (required): Array of 1-3 button objects, each with:
  • id (required): Unique identifier for the button
  • title (required): Button text, maximum 20 characters
• header_text (optional): Text to display at the top of the message
• footer_text (optional): Text to display at the bottom of the message

send_interactive_list

Present users with a structured list of options organized into sections, ideal for menus, catalogs, or multi-option selections.

Parameters:

• recipient (required): Phone number in international format
• body_text (required): Main message content
• button_text (required): Text on the button that opens the list, maximum 20 characters
• sections (required): Array of section objects containing:
  • title (optional): Section header
  • rows (required): Array of row objects with:
    • id (required): Unique row identifier
    • title (required): Row title, maximum 24 characters
    • description (optional): Row description, maximum 72 characters
• header_text (optional): Message header text
• footer_text (optional): Message footer text

mark_message_as_read

Update the read status of received messages to maintain proper conversation tracking and status indicators.

Parameters:

• message_id (required): The unique identifier of the message to mark as read

list_message_templates

Retrieve all approved message templates associated with your WhatsApp Business Account, including their structure and available languages.

Parameters:

• limit (optional): Number of templates to return in a single request (default: 100)
• after (optional): Pagination cursor for retrieving additional results

upload_media

Upload media files to WhatsApp's servers to obtain a media ID that can be used when sending media messages. This is useful for media you'll send multiple times or need to prepare in advance.

Parameters:

• media_url (required): Direct URL to the media file to upload
• media_type (required): MIME type of the media (e.g., 'image/jpeg', 'video/mp4', 'application/pdf')

delete_media

Remove media files from WhatsApp's servers when they're no longer needed, helping manage storage and maintain organization.

Parameters:

• media_id (required): The unique identifier of the media file to delete

Resource Templates

media

Access detailed information about specific media files, including download URLs and metadata.

URI Pattern: whatsapp://media/{media_id}

Retrieve media details by providing the media ID obtained when uploading or receiving media messages.

business_profile

Get comprehensive information about your WhatsApp Business profile, including business description, contact details, and profile settings.

URI Pattern: whatsapp://profile/business

Access your business profile data to verify settings or retrieve information for display purposes.

phone_profile

Retrieve profile information and quality metrics for specific phone numbers associated with your WhatsApp Business Account.

URI Pattern: whatsapp://profile/phone/{phone_number_id}

Monitor phone number status, quality ratings, and other important metrics for your business numbers.

template

Access detailed information about specific message templates, including their structure, components, and available languages.

URI Pattern: whatsapp://template/{template_name}

Review template details to understand required parameters and formatting before sending template messages.

Use Cases

This MCP server excels in numerous business scenarios:

Customer Support: Respond to customer inquiries with text messages, send helpful documents, share locations of service centers, and use interactive buttons for common queries.

Marketing and Notifications: Send approved template messages for order confirmations, shipping updates, appointment reminders, and promotional announcements while maintaining compliance with WhatsApp policies.

Sales and Lead Management: Share product catalogs using interactive lists, send contact cards for team members, provide location information for showrooms, and engage prospects with rich media content.

Automated Workflows: Integrate WhatsApp messaging into your existing automation systems, enabling seamless communication triggers based on business events and customer actions.

Message Types Explained

The server supports the full spectrum of WhatsApp Business messaging capabilities. Text messages provide simple, straightforward communication. Media messages enable visual storytelling through images and videos, or sharing important documents and audio files. Location messages help customers find you or provide delivery coordinates. Contact messages facilitate network building by making it easy to share professional connections.

Interactive messages represent the cutting edge of WhatsApp Business communication. Button-based messages provide quick reply options for common scenarios like "Yes/No" questions or "Contact Us/Learn More" choices. List messages organize multiple options into a clean, scrollable interface perfect for product selection, service categories, or navigation menus.

Template messages ensure compliance with WhatsApp's business messaging policies while enabling automated communications. These pre-approved messages can include variables for personalization while maintaining the approved structure.

Getting Started

To begin using the WhatsApp MCP Server, ensure you have access to the WhatsApp Business API and the necessary credentials. Once connected, you can immediately start sending messages using any of the available tools. The server handles all API authentication and request formatting, allowing you to focus on crafting effective communications.

Start with simple text messages to verify your setup, then explore media messages and interactive options as you become more comfortable with the platform. Use the template listing tool to discover available templates, and leverage the resource templates to access profile and media information as needed.