WSAPI WhatsApp MCP Server
WSAPI WhatsApp MCP Server lets LLMs interact with WhatsApp via WSAPI through 80+ tools across 12 categories, enabling messaging, contact/group/chat management, session handling, and more.
Send and manage messages: text, images, videos, audio, voice, documents, stickers, links, locations, contacts, reactions, edits, deletions, pins, stars, read receipts, and more.
Manage contacts: list, get, create/update, sync, block/unblock.
Manage groups: create, update info/picture, participants, invite links, join requests, settings (announce, locked, approval, etc.).
Manage chats: list, get, delete, mute, archive, pin, mark read/unread, request history, set presence, ephemeral timers.
Manage session: status, QR code, pairing code, logout, flush history.
Manage own profile and privacy settings.
Check phone numbers and get user profiles.
Manage communities: create, participants, sub-groups, invite links, link/unlink groups.
Manage newsletters: list, create, subscribe, mute.
Post and delete status updates (text/image/video).
Reject incoming calls.
Filter tools by category or individual tool to reduce context window usage.
Provides comprehensive WhatsApp functionality through the WSAPI service, enabling AI assistants to send messages, manage contacts and groups, handle chat operations, set presence status, manage account settings, and perform session management including QR code login and device pairing.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@WSAPI WhatsApp MCP Server send a message to John saying I'll be there in 10 minutes"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@wsapichat/mcp-server
A Model Context Protocol (MCP) server for WSAPI - the WhatsApp API Gateway. Enables LLMs to send messages, manage contacts and groups, handle communities and newsletters, post status updates, and more through WhatsApp.
For comprehensive documentation, see the WSAPI MCP Server guide.
Note: This project is not affiliated with, associated with, or endorsed by WhatsApp or Meta.
Installation
Prerequisites
Node.js >= 20.19.0
WSAPI account with API credentials (wsapi.chat)
Claude Desktop
Add to your Claude Desktop configuration:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"wsapi": {
"command": "npx",
"args": ["@wsapichat/mcp-server"],
"env": {
"WSAPI_API_KEY": "your_api_key_here",
"WSAPI_INSTANCE_ID": "your_instance_id_here",
"WSAPI_ENABLED_CATEGORIES": "messaging,contacts"
}
}
}
}Claude Code
claude mcp add wsapi -- npx @wsapichat/mcp-server \
--env WSAPI_API_KEY=your_api_key_here \
--env WSAPI_INSTANCE_ID=your_instance_id_here \
--env WSAPI_ENABLED_CATEGORIES=messaging,contactsRelated MCP server: MCP WPPConnect Server
Tool Filtering
The server exposes 80+ tools across 12 categories. To reduce context window usage, you can filter which tools are loaded using environment variables.
By category
Load only messaging and contact tools:
WSAPI_ENABLED_CATEGORIES=messaging,contactsAvailable categories: messaging, contacts, groups, chats, session, users, communities, newsletters, status, calls, media
By individual tool
Load only specific tools:
WSAPI_ENABLED_TOOLS=whatsapp_send_text,whatsapp_send_image,whatsapp_get_contactsCombined
Use categories as a base set and add individual tools from other categories:
WSAPI_ENABLED_CATEGORIES=messaging
WSAPI_ENABLED_TOOLS=whatsapp_get_contacts,whatsapp_get_chatsIf neither variable is set, all tools are loaded.
Configuration
Variable | Required | Default | Description |
| Yes | - | Your WSAPI API key |
| Yes | - | Your WSAPI instance ID |
| No |
| WSAPI base URL |
| No | (all) | Comma-separated tool categories to load |
| No | (all) | Comma-separated tool names to load |
| No |
| Logging level (error, warn, info, debug) |
Development
git clone https://github.com/wsapi-chat/wsapi-mcp
cd wsapi-mcp
npm install
cp .env.example .env # Edit with your credentials
npm run build
npm startLicense
MIT - see LICENSE for details.
Links
Unreleased contract update
The source covers 101 WhatsApp operations; Cloud Account/subscription and OSS admin APIs are outside this integration's scope. Changes in this working tree have not been published. See CHANGELOG.md.
Available Tools
101 toolswhatsapp_archive_chatAIdempotent
Archive or unarchive a chat. Archiving only hides it from the main list on this account; messages are kept and it can be undone. Returns a success confirmation.
Inputs: chatId (required), archived (required).
whatsapp_block_contactAIdempotent
Block a contact by user JID: they can no longer message or call this number, and they are not notified. Reversible with whatsapp_unblock_contact. Returns a success confirmation.
Inputs: id (required).
whatsapp_bulk_check_usersARead-only
Check many phone numbers at once for WhatsApp accounts. Read-only. Pass numbers with country code, digits only. Returns whether each number is registered, with its user JID.
Inputs: phones (required).
whatsapp_check_userARead-only
Check whether one phone number has WhatsApp, before sending to it. Read-only. Pass the number with country code, digits only. Returns whether it is registered and its user JID. For many numbers at once, use whatsapp_bulk_check_users.
Inputs: phone (required).
whatsapp_clear_chatADestructiveIdempotent
Delete all messages in a chat on this account but keep the chat in the list. It cannot be undone and does not affect other participants. To remove the chat entirely, use whatsapp_delete_chat. Returns a success confirmation.
Inputs: chatId (required).
whatsapp_create_communityA
Create a new WhatsApp community with this number as its admin, optionally adding participants. Participants are added immediately and notified. Returns the new community JID.
Inputs: name (required), approvalMode, participants.
whatsapp_create_community_groupA
Create a new group inside a community, optionally with participants, who are added and notified. Requires community admin rights. To attach a group that already exists, use whatsapp_link_group_to_community. Returns the new group JID.
Inputs: id (required), name (required), participants.
whatsapp_create_contactAIdempotent
Save a contact on the connected number, or update its name if it already exists. Only affects this account's address book. Returns a success confirmation.
Inputs: id (required), fullName (required), firstName.
whatsapp_create_groupA
Create a new group with this number as admin and the given participants (user JIDs). Participants are added immediately and notified. Calling it twice creates two groups. Returns the new group JID.
Inputs: name (required), participants (required).
whatsapp_create_newsletterA
Create a new WhatsApp channel (newsletter) owned by this number, with a name and optional description and picture. It is public once created. Returns the new channel JID.
Inputs: name (required), picture, description.
whatsapp_delete_chatADestructiveIdempotent
Delete a whole chat and its messages from this account. It cannot be undone, and it only affects this account: the other participants keep their copy. To empty a chat but keep it in the list, use whatsapp_clear_chat. Returns a success confirmation.
Inputs: chatId (required).
whatsapp_delete_messageADestructiveIdempotent
Delete a message for everyone in the chat. It cannot be undone; participants see that a message was deleted. Only works on messages this number sent (or, as group admin, on others' messages in the group). To hide a message only on this account, use whatsapp_delete_message_for_me. Returns a success confirmation.
Inputs: chatId (required), senderId (required), messageId (required).
whatsapp_delete_message_for_meADestructiveIdempotent
Delete a message only on this account. Other participants still see it. It cannot be undone. To remove it for everyone, use whatsapp_delete_message. Returns a success confirmation.
Inputs: chatId (required), messageId (required), isFromMe, senderId, +1 more.
whatsapp_delete_statusADestructiveIdempotent
Delete a status this number posted, by its message ID. Contacts stop seeing it. It cannot be undone. Returns a success confirmation.
Inputs: messageId (required).
whatsapp_download_mediaARead-only
Download the file attached to a received message, using media.id from the message event. Read-only. Returns the file as binary content, with its MIME type.
Inputs: id (required).
whatsapp_edit_messageAIdempotent
Edit the text of a message this number sent. Everyone in the chat sees it marked as edited. WhatsApp only allows it for about 15 minutes after sending. Returns a success confirmation.
Inputs: to (required), text (required), messageId (required), mentions, +1 more.
whatsapp_flush_historyAIdempotent
Re-publish the history sync messages cached for this instance as events. It does not return messages: they arrive later through the event stream. Returns an acknowledgement.
Inputs: no named parameters.
whatsapp_get_blocklistARead-only
List the contacts this number has blocked. Read-only. To change it, use whatsapp_block_contact or whatsapp_unblock_contact. Returns the blocked JIDs.
Inputs: no named parameters.
whatsapp_get_chatARead-only
Get the details of one chat by its JID: name, unread state, and settings such as mute, pin, archive and disappearing timer. Read-only. Returns the chat object.
Inputs: chatId (required).
whatsapp_get_chat_business_profileARead-only
Get the WhatsApp Business profile of a chat: description, category, website, email and address. Read-only. Only business accounts have one. Returns the profile object.
Inputs: chatId (required).
whatsapp_get_chat_pictureARead-only
Get the profile picture of a chat (a contact or a group) by its JID. Read-only. Returns the picture URL and ID; fails if the chat has no picture or it is hidden by privacy settings.
Inputs: chatId (required).
whatsapp_get_chatsARead-only
List every chat on the connected number, both direct and group. Read-only. Use this to discover chat JIDs; use whatsapp_get_chat for one chat's details. Returns the chats and their count.
Inputs: no named parameters.
whatsapp_get_communityARead-only
Get the details of a community by its JID: name, description, settings and announcement group. Read-only. Returns the community object.
Inputs: id (required).
whatsapp_get_community_invite_linkARead-only
Get the current invite link of a community. Requires admin rights. Anyone with the link can ask to join. Returns the link.
Inputs: id (required).
whatsapp_get_community_participantsCRead-only
List the participants of a community, with their admin status. Read-only. Returns the participants.
Inputs: id (required).
whatsapp_get_community_sub_groupsARead-only
List the groups linked to a community. Read-only. Returns the groups and their JIDs.
Inputs: id (required).
whatsapp_get_contactARead-only
Get one saved contact by JID: saved name, push name and business name. Read-only. Returns the contact object.
Inputs: id (required).
whatsapp_get_contactsARead-only
List the contacts saved on the connected number. Read-only. To check whether a phone number has WhatsApp, use whatsapp_check_user. Returns the contacts and their count.
Inputs: no named parameters.
whatsapp_get_groupARead-only
Get the details of a group by JID: name, description, settings and participants. Read-only. Returns the group object.
Inputs: id (required).
whatsapp_get_group_info_from_linkARead-only
Preview a group from an invite code without joining it: name, description and size. Read-only. Returns the group info.
Inputs: code (required).
whatsapp_get_group_invite_linkARead-only
Get the current invite link of a group. Requires admin rights. Anyone with the link can join. Returns the link.
Inputs: id (required).
whatsapp_get_group_participantsCRead-only
List a group's participants with their admin status. Read-only. Returns the participants.
Inputs: id (required).
whatsapp_get_group_requestsARead-only
List the pending requests to join a group that has join approval on. Requires admin rights. Read-only. Returns the requesting user JIDs.
Inputs: id (required).
whatsapp_get_groupsARead-only
List the groups the connected number belongs to. Read-only. Use this to find group JIDs (ending in @g.us). Returns the groups and their count.
Inputs: no named parameters.
whatsapp_get_my_profileARead-only
Get the connected number's own profile: name, about text and picture. Read-only. Returns the profile.
Inputs: no named parameters.
whatsapp_get_newsletterARead-only
Get a channel's details by JID: name, description and follower count. Read-only. Returns the channel object.
Inputs: id (required).
whatsapp_get_newsletter_by_inviteARead-only
Look up a channel by its invite code, without following it. Read-only. Returns the channel info and JID.
Inputs: code (required).
whatsapp_get_pair_codeARead-only
Get an 8-character pairing code for a phone number, to link it without scanning a QR (WhatsApp, Linked devices, Link with phone number). Only works while logged out. Returns the code.
Inputs: phone (required).
whatsapp_get_privacy_settingsARead-only
Get the account's privacy settings: who can see last seen, profile picture, about, groups and read receipts. Read-only. Returns the settings.
Inputs: no named parameters.
whatsapp_get_qr_codeARead-only
Get the login QR code as a text string, to pair a phone with this instance. Only works while logged out, and each code expires within about a minute. For an image, use whatsapp_get_qr_code_image; to pair by phone number, use whatsapp_get_pair_code. Returns the QR string.
Inputs: no named parameters.
whatsapp_get_qr_code_imageARead-only
Get the login QR code as a PNG image, to scan from WhatsApp on the phone (Linked devices). Only works while logged out, and each code expires within about a minute. Returns the image.
Inputs: no named parameters.
whatsapp_get_session_statusARead-only
Check whether the WhatsApp session is connected and logged in. Read-only. Call it first when other tools fail, to tell a logged-out session from another error. Returns the connection and login state.
Inputs: no named parameters.
whatsapp_get_status_privacyARead-only
Get who can see this number's status updates. Read-only. Returns the privacy settings.
Inputs: no named parameters.
whatsapp_get_user_profileARead-only
Get another user's public profile by phone number: name, about text, picture and business status, as far as their privacy settings allow. Read-only. Returns the profile.
Inputs: phone (required).
whatsapp_join_group_with_inviteB
Accept a group invite that was received as a direct message (not a link), using the fields from that invite message. Other participants see this number join. Returns a success confirmation.
Inputs: code (required), groupId (required), inviterId (required), expiration.
whatsapp_join_group_with_linkA
Join a group using the code from an invite link (chat.whatsapp.com/). Other participants see this number join. To preview the group first, use whatsapp_get_group_info_from_link. Returns the joined group JID.
Inputs: code (required).
whatsapp_leave_communityADestructiveIdempotent
Leave a community and all its groups. Other members are notified, and rejoining needs a new invite. Returns a success confirmation.
Inputs: id (required).
whatsapp_leave_groupADestructiveIdempotent
Leave a group. Other participants are notified, and rejoining needs a new invite. If this number is the only admin, WhatsApp picks another one. Returns a success confirmation.
Inputs: id (required).
whatsapp_link_group_to_communityAIdempotent
Attach an existing group to a community. Requires admin rights in both. Group members become part of the community. Returns a success confirmation.
Inputs: id (required), groupId (required).
whatsapp_list_communitiesARead-only
List the communities the connected number belongs to. Read-only. Returns the communities and their JIDs.
Inputs: no named parameters.
whatsapp_list_newslettersARead-only
List the channels (newsletters) this number follows or owns. Read-only. Returns the channels and their JIDs.
Inputs: no named parameters.
whatsapp_logoutADestructiveIdempotent
Log this instance out of WhatsApp and unlink it from the phone. Every other tool stops working until the number is paired again with a QR or pair code. Returns a success confirmation.
Inputs: no named parameters.
whatsapp_mark_chat_as_readAIdempotent
Mark a whole chat as read or unread on this account. To send a read receipt for one message, use whatsapp_mark_message_read. Returns a success confirmation.
Inputs: read (required), chatId (required).
whatsapp_mark_message_readAIdempotent
Send a read receipt for a message, so the sender sees it as read (blue ticks, if their privacy settings allow). To mark a whole chat, use whatsapp_mark_chat_as_read. Returns a success confirmation.
Inputs: chatId (required), senderId (required), messageId (required), receiptType (required).
whatsapp_mute_chatAIdempotent
Mute a chat's notifications for a duration, or unmute it. Only affects this account; the other side is not told. Returns a success confirmation.
Inputs: chatId (required), duration (required).
whatsapp_mute_newsletterBIdempotent
Mute or unmute a channel's notifications on this account. Returns a success confirmation.
Inputs: id (required), mute (required).
whatsapp_pin_chatAIdempotent
Pin a chat to the top of the chat list, or unpin it. Only affects this account. To pin a message inside a chat, use whatsapp_pin_message. Returns a success confirmation.
Inputs: chatId (required), pinned (required).
whatsapp_pin_messageAIdempotent
Pin or unpin a message in a chat, optionally for a limited time. Everyone in the chat sees the pin. To pin a whole chat in the list, use whatsapp_pin_chat. Returns a success confirmation.
Inputs: chatId (required), senderId (required), messageId (required), pinned, +1 more.
whatsapp_post_image_statusA
Post an image status (story) from base64 data or a public URL, with an optional caption, visible to allowed contacts for 24 hours. Not idempotent. Returns the status message ID.
Inputs: url, data, caption, mimeType.
whatsapp_post_text_statusA
Post a text status (story), visible to contacts allowed by the status privacy settings for 24 hours. Not idempotent. Returns the status message ID, which whatsapp_delete_status needs.
Inputs: text (required).
whatsapp_post_video_statusA
Post a video status (story) from base64 data or a public URL, with an optional caption, visible to allowed contacts for 24 hours. Not idempotent. Returns the status message ID.
Inputs: url, data, caption, mimeType.
whatsapp_reject_callAIdempotent
Reject an incoming WhatsApp call, using the callId and callerId from the call_offer event. The caller sees the call as declined. Only works while the call is still ringing. Returns a success confirmation.
Inputs: callId (required), callerId (required).
whatsapp_request_chat_messagesA
Ask WhatsApp for older messages of a chat, starting before a given message. It does not return messages: they arrive later as history sync events, if the phone provides them. Returns an acknowledgement only.
Inputs: chatId (required), lastMessageId (required), lastMessageSenderId (required), count.
whatsapp_reset_community_invite_linkADestructiveIdempotent
Revoke a community's invite link and create a new one. The old link stops working immediately. Requires admin rights. Returns the new link.
Inputs: id (required).
whatsapp_reset_group_invite_linkADestructiveIdempotent
Revoke a group's invite link and create a new one. The old link stops working immediately. Requires admin rights. Returns the new link.
Inputs: id (required).
whatsapp_send_audioA
Send an audio file as a regular audio attachment, from base64 data or a public URL. For a voice note that plays like a recorded message, use whatsapp_send_voice. Not idempotent. Returns the message ID.
Inputs: to (required), url, data, replyTo, +6 more.
whatsapp_send_contactA
Send a contact card, either from a display name or a full vCard. The recipient can save it to their address book. Not idempotent. Returns the message ID.
Inputs: to (required), vcard, replyTo, mentions, +4 more.
whatsapp_send_documentA
Send a file as a document, from base64 data or a public URL, with a required filename and optional caption. Use it for PDFs and any file that should not be shown inline as media. Not idempotent. Returns the message ID.
Inputs: to (required), filename (required), url, data, +7 more.
whatsapp_send_imageA
Send an image, from base64 data or a public URL, with an optional caption, to a user or group JID. The recipient receives it immediately; set viewOnce for a view-once image. Not idempotent. Returns the message ID.
Inputs: to (required), url, data, caption, +7 more.
whatsapp_send_linkA
Send a text message with a link preview (title, description and thumbnail). Use it instead of whatsapp_send_text when you want to control how the preview looks. Not idempotent. Returns the message ID.
Inputs: to (required), url (required), text (required), title, +7 more.
whatsapp_send_locationA
Send a map location by latitude and longitude, with an optional place name and address. Not idempotent. Returns the message ID.
Inputs: to (required), latitude (required), longitude (required), url, +3 more.
whatsapp_send_reactionAIdempotent
React to a message with an emoji, or remove this number's reaction by sending an empty string. Everyone in the chat sees it. Repeating it replaces the reaction. Returns a success confirmation.
Inputs: to (required), reaction (required), messageId (required), senderId.
whatsapp_send_stickerA
Send a sticker in WebP format, from base64 data or a public URL. Not idempotent. Returns the message ID.
Inputs: to (required), url, data, replyTo, +5 more.
whatsapp_send_textA
Send a text message to a user JID or a group JID (@g.us). The recipient receives it immediately and it cannot be unsent, only deleted with whatsapp_delete_message. Supports mentions, replies and a disappearing timer. Not idempotent: calling it twice sends two messages. Returns the message ID.
Inputs: to (required), text (required), replyTo, mentions, +3 more.
whatsapp_send_videoA
Send a video, from base64 data or a public URL, with an optional caption, to a user or group JID. The recipient receives it immediately. Not idempotent. Returns the message ID.
Inputs: to (required), url, data, caption, +7 more.
whatsapp_send_voiceA
Send a voice note (push-to-talk), from base64 data or a public URL; OGG/Opus plays best. It appears as a recorded voice message. For a music or audio file, use whatsapp_send_audio. Not idempotent. Returns the message ID.
Inputs: to (required), url, data, replyTo, +6 more.
whatsapp_set_chat_ephemeralAIdempotent
Set the disappearing messages timer for a chat (off, 24 hours, 7 days or 90 days). All participants see the change and new messages follow it. Returns a success confirmation.
Inputs: chatId (required), expiration (required).
whatsapp_set_chat_presenceAIdempotent
Show a typing or recording indicator in a chat, or clear it with paused. The other side sees it in real time. Use it just before sending a reply; it does not send anything by itself. Returns a success confirmation.
Inputs: state (required), chatId (required).
whatsapp_set_community_descriptionAIdempotent
Change a community's description. Requires admin rights; all members see it. Returns a success confirmation.
Inputs: id (required), description.
whatsapp_set_community_lockedAIdempotent
Turn locked mode on or off for a community. When on, only admins can edit the community's info. Requires admin rights. Returns a success confirmation.
Inputs: id (required), enabled (required).
whatsapp_set_community_nameAIdempotent
Rename a community. Requires admin rights; all members see the change. Returns a success confirmation.
Inputs: id (required), name (required).
whatsapp_set_community_pictureAIdempotent
Set a community's profile picture from base64 image data. Requires admin rights; replaces the current picture for all members. Returns a success confirmation.
Inputs: id (required), data (required).
whatsapp_set_group_announceAIdempotent
Turn announcement mode on or off. When on, only admins can send messages in the group. Requires admin rights. Returns a success confirmation.
Inputs: id (required), enabled (required).
whatsapp_set_group_join_approvalAIdempotent
Turn join approval on or off. When on, people joining by link need an admin to approve them (see whatsapp_get_group_requests). Requires admin rights. Returns a success confirmation.
Inputs: id (required), enabled (required).
whatsapp_set_group_lockedAIdempotent
Turn locked mode on or off. When on, only admins can edit the group's name, description and picture. Requires admin rights. Returns a success confirmation.
Inputs: id (required), enabled (required).
whatsapp_set_group_member_add_modeAIdempotent
Choose whether only admins or all members can add participants to a group. Requires admin rights. Returns a success confirmation.
Inputs: id (required), onlyAdminAdd (required).
whatsapp_set_group_pictureAIdempotent
Set a group's picture from base64 image data, replacing the current one for all participants. May require admin rights. Returns a success confirmation.
Inputs: id (required), data (required).
whatsapp_set_newsletter_subscriptionAIdempotent
Follow or unfollow a channel by JID. Following adds its updates to this account; the channel owner only sees the follower count. Returns a success confirmation.
Inputs: id (required), subscribed (required).
whatsapp_set_presenceAIdempotent
Set this account as available or unavailable. Available makes it show online to contacts; for a typing indicator in one chat, use whatsapp_set_chat_presence. Returns a success confirmation.
Inputs: presence (required).
whatsapp_set_privacy_settingAIdempotent
Change one privacy setting of the account, for example who can see the profile picture. Applies immediately to all contacts. Returns the updated settings.
Inputs: value (required), setting (required).
whatsapp_star_messageAIdempotent
Star or unstar a message on this account. Only this account sees it. Returns a success confirmation.
Inputs: chatId (required), senderId (required), messageId (required), starred.
whatsapp_subscribe_chat_presenceAIdempotent
Subscribe to a contact's presence (online, typing) so it arrives as presence events. It does not return presence: the updates come later through the event stream. Returns a success confirmation.
Inputs: chatId (required).
whatsapp_sync_contactsAIdempotent
Re-sync the address book from the WhatsApp servers. Use it when whatsapp_get_contacts looks outdated. It runs in the background. Returns an acknowledgement, not the contacts.
Inputs: no named parameters.
whatsapp_unblock_contactAIdempotent
Unblock a previously blocked contact, so they can message and call this number again. Returns a success confirmation.
Inputs: id (required).
whatsapp_unlink_community_groupADestructiveIdempotent
Detach a group from a community. The group keeps existing on its own, but its members lose access to the community through it. Requires admin rights. Returns a success confirmation.
Inputs: id (required), groupId (required).
whatsapp_update_community_participantsADestructiveIdempotent
Add, remove, promote to admin or demote participants of a community, by user JID. Requires admin rights. Removed participants lose access and everyone affected is notified. Returns a success confirmation.
Inputs: id (required), action (required), participants (required).
whatsapp_update_group_descriptionAIdempotent
Change a group's description. All participants see it; it may require admin rights if the group is locked. Returns a success confirmation.
Inputs: id (required), description.
whatsapp_update_group_nameAIdempotent
Rename a group. All participants see the change; it may require admin rights if the group is locked. Returns a success confirmation.
Inputs: id (required), name (required).
whatsapp_update_group_participantsADestructiveIdempotent
Add, remove, promote to admin or demote participants of a group, by user JID. Requires admin rights. Removed participants lose access and everyone affected is notified. Some adds can fail silently because of the invitee's privacy settings, so check with whatsapp_get_group_participants. Returns a success confirmation.
Inputs: id (required), action (required), participants (required).
whatsapp_update_group_requestsAIdempotent
Approve or reject pending join requests for a group, by user JID. Approved users become participants immediately. Requires admin rights. Returns a success confirmation.
Inputs: id (required), action (required), participants (required).
whatsapp_update_my_profileAIdempotent
Change the connected number's own display name, about text or picture. Contacts see the change. Only the fields you pass are updated. Returns a success confirmation.
Inputs: name, status, picture.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 101 tools
Tools have distinct purposes and descriptions explicitly cross-reference to differentiate similar ones (e.g., send_audio vs send_voice, delete_message vs delete_message_for_me). However, the sheer number of tools may still cause some confusion in selection.
All tools follow a consistent whatsapp_ prefix with snake_case verb_noun pattern, with logical verb choices (get vs list). No mixed conventions.
101 tools is extreme for this domain, far exceeding the recommended 3-15 range. Many tools are highly granular and could be consolidated.
The surface covers messaging, chats, groups, communities, newsletters, status, calls, contacts, and session management comprehensively. Missing features like polls or live location sharing prevent a perfect score.
Maintenance
Related MCP Connectors
Send WhatsApp messages and templates, manage chats, contacts, broadcasts and AI agents.
WhatsApp for Claude, ChatGPT or any AI agent: search, reply and send. Personal or Business API.
I send and manage WhatsApp Web messages through your linked session
WhatsMCP connects Claude and other MCP-compatible AI agents directly to WhatsApp. Send and receive text, images, documents, and voice notes; manage groups (create, add/remove members, promote admins); look up contacts and profiles; follow channels; and read call and message history — all through a standard MCP interface. For voice use cases, WhatsMCP offers SIP-based calling plans (inbound-only, or full inbound/outbound) so AI voice agents can answer and place WhatsApp calls, plus low-latency WebSocket integrations with voice agent providers like ElevenLabs. Multiple WhatsApp accounts can be paired and managed per workspace, with webhook support for real-time inbound message delivery to your own infrastructure.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables AI assistants to interact with WhatsApp through the WAHA (WhatsApp HTTP API) platform. Supports chat management, message operations including sending/receiving messages, and marking chats as read.5211ISC
- FlicenseNot gradedqualityNot gradedmaintenanceEnables WhatsApp automation through MCP protocol, allowing users to manage sessions, send messages, handle groups/communities, and access contacts through natural language interactions with AI agents.5 npm-
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage WhatsApp communications by sending messages, managing groups, and analyzing conversation patterns via the WaliChat API. It supports tasks like message scheduling, contact management, and automated business workflows through natural language commands.12 npm1MIT
- AlicenseBqualityDmaintenanceEnables AI agents to control WhatsApp, including sending messages and media, reading chats, managing groups and communities, with QR/pairing auth and session persistence.1415 npm2MIT