Maytapi MCP Server for WhatsApp API

Connect your AI assistant to WhatsApp using the Model Context Protocol (MCP). Send messages, manage groups, channels, communities, catalogs, labels, and more -- directly from Claude, Cursor, or any MCP-compatible AI tool.

What is MCP?

The Model Context Protocol (MCP) is an open standard developed by Anthropic that enables AI assistants to connect with external tools and services. Think of it as a universal adapter between AI and your applications.

With the Maytapi MCP Server, your AI assistant can directly interact with the WhatsApp API -- sending messages, managing contacts, handling groups, channels, communities, catalogs, and more -- all through natural language commands.

Quick Setup

No installation required. Add the following configuration to your MCP client settings:

Loading...

Replace your-product-id and your-api-token with your credentials from the Maytapi Console.

How It Works

1
Install the MCP Server

Run via npx (no install needed) or install the Maytapi MCP Server globally via npm. Configure it with your Product ID and API Token.

2
Connect Your AI Tool

Add the MCP server configuration to Claude Desktop, Claude Code, Cursor, or your preferred MCP client.

3
Start Using WhatsApp via AI

Ask your AI assistant to send messages, manage groups, create channels -- all through natural language.

Configuration File Locations

Client Path
Claude Desktop (macOS)~/Library/Application Support/Claude/claude_desktop_config.json
Claude Desktop (Windows)%APPDATA%\Claude\claude_desktop_config.json
Claude Code~/.claude.json
CursorCursor Settings > MCP

Available Tools

The Maytapi MCP Server exposes 80+ tools covering the full WhatsApp API. Here is the complete list grouped by category.

Product & Phone Management

Tool Name Description
get_productReturns product information
list_phonesLists all phones registered to the product
add_phoneAdds a new phone to the product
get_statusReturns the status of the current session
get_screenReturns screenshot of the current session screen
get_qr_codeReturns the QR code for phone pairing
connect_with_phone_numberConnect with phone number instead of QR code
logoutLogs out the number from current session
get_phone_logsReturns logs for a specific phone (incoming/outgoing filter)

Messaging

Tool Name Description
send_messageSends messages to any chat. Supports 30+ message types: text, media, poll, vcard, contact, location, sticker, link, buttons, list, forward, delete, reaction, unreact, edit, pin, star, product, catalog, group invite, channel messages (text/media/link/poll/sticker/audio/delete), story replies (text/media), short video, and create event.
get_messageRetrieves information about a specific message by ID
get_messagesRetrieves messages from a conversation with pagination, author filter, and fromMe filter

Group Management

Tool Name Description
create_groupCreates a new WhatsApp group with participants, optional invite message and profile image
get_groupsLists all groups with optional participant loading, sorting, invite links, and pagination
get_groupGets specific group info with optional invite link generation
group_addAdds participants to a group with optional invitation
group_removeRemoves a participant from a group
group_promotePromotes a participant to admin
group_demoteDemotes an admin to participant
group_configConfigures group settings: edit, send, disappear, membersCanAddMembers, approveNewMembers, name, description
set_group_profile_imageSets group profile picture (512x512 recommended)
delete_group_profile_imageDeletes group profile picture
group_accept_inviteAccepts a group invitation by invite code
group_revoke_inviteRevokes and regenerates group invite link
group_approval_request_listLists pending join requests for a group
group_approve_requestApproves pending join requests
group_reject_requestRejects pending join requests
get_group_info_by_invite_codeGets group info using invite code
leave_groupLeaves a WhatsApp group

Contact Operations

Tool Name Description
get_contactsLists all contacts
get_contactGets specific contact information
check_phonesChecks WhatsApp registration status of multiple phone numbers
block_contactBlocks or unblocks a contact
get_profile_imageGets profile picture of a contact or group
set_profile_imageSets your WhatsApp account profile picture
delete_profile_imageDeletes your WhatsApp account profile picture
contact_addAdds a new contact to WhatsApp address book (requires "Manage contacts from web" enabled)
contact_editEdits an existing contact in WhatsApp address book
contact_removeRemoves a contact from WhatsApp address book

Chat Operations

Tool Name Description
get_conversationsLists all conversations/chats with pagination
get_conversationGets specific conversation details with messages, author filter, and fromMe filter
favorite_conversationAdds or removes a conversation from favorites
pin_conversationPins or unpins a conversation
archive_conversationArchives or unarchives a conversation
mute_conversationMutes or unmutes a conversation (8 hours, 1 week, or forever)
clear_conversationClears all messages from a conversation

Channel Operations

Tool Name Description
create_channelCreates a new WhatsApp channel with name, description, and image
get_channelsLists all channels with optional invite links
get_channelGets specific channel info
delete_channelDeletes a channel you own
channel_configConfigures channel settings (name, description, image)
channel_invite_codeGets invite code/link for a channel
channel_subscribeSubscribes to a channel
channel_unsubscribeUnsubscribes from a channel
channel_subscribe_by_invite_codeSubscribes to a channel using invite code
channel_unsubscribe_by_invite_codeUnsubscribes from a channel using invite code
channel_get_messagesGets messages from a channel with pagination
channel_searchSearches channels by text
channel_search_by_countrySearches channels by country code (ISO 2-letter)
channel_get_info_by_invite_codeGets channel info using invite code
channel_statisticsGets channel statistics and analytics
channel_demoteDemotes an admin in a channel
channel_accept_admin_inviteAccepts a channel admin invitation
channel_revoke_admin_inviteRevokes admin invitation for a number

Community Operations

Tool Name Description
create_communityCreates a new WhatsApp community with optional subgroups
get_communitiesLists all communities with optional detailed info and pagination
get_communityGets details of a specific community
community_addAdds participants to a community with optional invitation
community_removeRemoves a participant from a community
community_promotePromotes a participant to community admin
community_demoteDemotes a community admin to participant
community_add_subgroupAdds existing groups as subgroups to a community
community_remove_subgroupRemoves subgroups from a community
community_revoke_inviteRevokes and regenerates community invite link
deactivate_communityDeactivates a community

Story Operations Beta

Tool Name Description
get_storiesGets your own stories with pagination
get_contacts_storiesGets stories of all contacts
get_contact_storiesGets stories of a specific contact
create_storyCreates a new story (text with background color, or media with caption)

Label Operations

Tool Name Description
create_labelCreates a new label in WhatsApp Business with name and color
get_labelsLists all labels
get_label_chatsGets all chats that have a specific label assigned
get_label_colorsGets all available color options for labels
edit_labelEdits an existing label (name and/or color)
remove_labelsPermanently deletes one or more labels
add_label_to_chatAssigns a label to a chat
remove_label_from_chatRemoves a label from a chat

Business Catalog

Tool Name Description
get_catalog_productsLists all catalog products
get_catalog_productGets a specific catalog product
add_catalog_productAdds a new product (name, image, price, currency, description, URL)
edit_catalog_productEdits an existing catalog product
remove_catalog_productRemoves a product from the catalog
add_product_imageAdds an image to a catalog product
remove_product_imageRemoves an image from a catalog product
get_contact_catalog_productsLists catalog products from another WhatsApp Business contact
get_catalog_collectionsLists all catalog collections
get_catalog_collectionGets a specific collection with its products
add_catalog_collectionCreates a new catalog collection
edit_catalog_collectionEdits a catalog collection name
remove_catalog_collectionRemoves a catalog collection
add_collection_productsAdds products to a collection
remove_collection_productRemoves products from a collection
get_catalog_ordersLists orders with pagination, sorting, and conversation filter
get_catalog_orderGets detailed information about a specific order
get_catalogGets catalog products (legacy)

Presence Operations

Tool Name Description
get_presenceGets current presence status of a contact (online, offline, last seen)
subscribe_presenceSubscribes to receive presence updates for a contact via webhook
send_presenceSends your presence status (typing, recording, online, offline) to a contact

Call Operations

Tool Name Description
reject_callRejects an incoming call (callId obtained from webhook notification)
create_call_linkCreates a shareable call link for voice or video calls with scheduled timestamp

Webhook Configuration

Tool Name Description
set_webhookSets webhook URL for the product to receive incoming messages and events
set_ack_preferenceSets acknowledgment preference to enable/disable read receipt delivery via webhook

Example Usage

Once connected, simply tell your AI assistant what you want to do.

You say:

"Send a WhatsApp message to +1234567890 saying 'Hello, your order has been shipped!'"

AI does:

Calls send_message with type text, the phone number, and message content via Maytapi API.

You say:

"Create a WhatsApp group called 'Project Team' and add +1234567890, +0987654321"

AI does:

Calls create_group with the group name and participant numbers.

You say:

"Show me the status of my WhatsApp connection"

AI does:

Calls get_status to check the current WhatsApp session connection status.

You say:

"Create a new WhatsApp channel called 'Company Updates'"

AI does:

Calls create_channel with the channel name to create a new WhatsApp channel.

Why Use Maytapi MCP Server?

Bring the full power of WhatsApp messaging directly into your AI workflow.

  • 80+ tools covering messaging, groups, channels, communities, catalogs, labels, and more
  • No coding required -- just configure and start using
  • Works with Claude Desktop, Claude Code, Cursor and other MCP clients
  • Open standard -- not locked into any single AI provider

Automate your WhatsApp communication with the AI tools you already use.

Requirements

Get started with the Maytapi MCP Server in minutes.

  • Node.js 18 or higher installed on your machine
  • A Maytapi account with an active product (Sign up for free trial)
  • Your Product ID and API Token from the Maytapi Console
  • An MCP-compatible AI client (Claude Desktop, Cursor, etc.)

The MCP server runs locally on your machine and communicates with the Maytapi API over HTTPS.

Ready to Supercharge Your WhatsApp Communication?

Unlock powerful features for business messaging and automation with our WhatsApp API

Explore WhatsApp API

Perfect for businesses, developers, and power users

Frequently Asked Questions

What is MCP?

The Model Context Protocol (MCP) is an open standard created by Anthropic that allows AI assistants to connect to external tools and data sources. It provides a universal way for AI to interact with services like the Maytapi WhatsApp API.

Is the MCP Server free to use?

The MCP Server itself is free and open source. You only need an active Maytapi subscription to use the WhatsApp API. All Maytapi plans include full API access.

Which AI tools are supported?

Tested with Claude Desktop, Claude Code, and Cursor. Works with any AI tool that supports the Model Context Protocol standard.

Is my API token secure?

Yes. The MCP server runs locally on your machine. Your API credentials are stored in your local configuration and are never sent to any third party. All communication with the Maytapi API is done over HTTPS.

Do I need to know how to code?

Basic familiarity with running commands in a terminal is helpful, but no coding is required. Install Node.js, add the configuration, and start using it with your AI assistant.

Where can I get my API credentials?

Sign up or log in to the Maytapi Console. Your Product ID and API Token are available on the settings page.

Explore WhatsApp API for Your Customer

Unlock the Full Potential of WhatsApp API with unlimited Features Tailored for Your Brand's Success

Contact us to be our partner Send email to talk any condition, agreement, and prices