Skip to main content
Glama
gabriellopesdesouza2002

MCP WhatsApp

by gabriellopesdesouza2002
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
WUZAPI_TOKENYesYour user token for WhatsApp messaging
WUZAPI_BASE_URLNoBase URL of the WuzAPI server (default: http://localhost:7143)http://localhost:7143
WUZAPI_ADMIN_TOKENNoAdmin token for managing users (default: admin123)admin123
WUZAPI_PRIVACY_MODENoEnable privacy mode to mask sensitive data (set to 'true' to enable)false

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
whatsapp_connectA

Connect to WhatsApp. Shows QR code if not yet paired — scan with phone.

whatsapp_disconnectA

Logout from WhatsApp. ⚠️ DESTRUCTIVE. confirmed=True required — always ask user first.

whatsapp_statusA

Get WhatsApp session status (connected/disconnected/QR pending) and WuzAPI service health.

whatsapp_get_qrcodeA

Get QR code image for WhatsApp pairing. Scan with phone to connect.

whatsapp_get_datetimeA

Get current date and time (Brazil/São Paulo). Use to know today's date before comparing message timestamps.

whatsapp_force_syncA

Force full history sync by reconnecting. Use when messages are missing. Wait ~30s after.

whatsapp_reset_sessionA

Reset WhatsApp session completely — logout + wipe message history + clear media + fresh QR. ⚠️ DESTRUCTIVE. confirmed=True required.

whatsapp_send_textA

Send WhatsApp text. phone: country code, no '+' (e.g. 5511999998888). message: text content.

whatsapp_send_imageC

Send image via WhatsApp. phone: no '+'. image_url: public URL. caption: optional.

whatsapp_send_documentB

Send document/file via WhatsApp. phone: no '+'. document_url: public URL. filename/caption: optional.

whatsapp_send_audioC

Send audio via WhatsApp. phone: no '+'. audio_url: public URL.

whatsapp_send_videoC

Send video via WhatsApp. phone: no '+'. video_url: public URL. caption: optional.

whatsapp_send_locationC

Send location via WhatsApp. phone: no '+'. latitude/longitude: coords. name: optional label.

whatsapp_send_contactB

Send contact card (vCard) via WhatsApp. phone: recipient no '+'. contact_name/contact_phone: contact to share.

whatsapp_send_linkB

Send link with preview via WhatsApp. phone: no '+'. url: link. text: optional message.

whatsapp_reactA

React to a message with emoji. phone: chat number. message_id: target msg. emoji: e.g. '👍'.

whatsapp_mark_readC

Mark messages as read. phone: chat number. message_ids: list of IDs.

whatsapp_download_mediaC

Download media from a message (image/audio/video/doc). phone: chat. message_id: target msg.

whatsapp_get_messagesB

Get recent messages from a chat, sorted by timestamp. phone: no '+'. count: default 20.

whatsapp_get_chatsA

List all active WhatsApp chats with last message info.

whatsapp_reply_messageB

Reply quoting a message. phone: no '+'. message: reply text. quoted_message_id: original msg ID.

whatsapp_delete_messageA

Delete a message. ⚠️ DESTRUCTIVE. confirmed=True required — always ask user first. everyone: revoke for all.

whatsapp_send_pollB

Send poll. phone: no '+' or group JID. question: poll text. options: list of choices. max_answers: default 1.

whatsapp_get_unread_messagesB

Get recent incoming messages across all chats (from others, not sent by you). limit: default 20.

whatsapp_search_messagesB

Search messages by keyword across all synced history. query: term. limit: default 50.

whatsapp_forward_messageC

Forward a message to another chat. message_id: original msg. to_phone: number or group JID.

whatsapp_get_user_infoA

Get WhatsApp profile (name, about) for a number. phone: no '+'. For own session use whatsapp_status.

whatsapp_search_contactsA

Search contacts by name or nickname. Falls back to recent chat history when not found in phone book.

whatsapp_get_messages_by_contact_nameB

Get messages from a contact by name/nickname. only_today: filter today only. limit: default 20.

whatsapp_check_phonesB

Check if phone numbers are on WhatsApp. phones: list, country code, no '+'.

whatsapp_list_groupsA

List all WhatsApp groups.

whatsapp_get_group_infoC

Get group details. group_jid: group identifier (e.g. 120363...@g.us).

whatsapp_create_groupC

Create a WhatsApp group. name: group name. participants: list of phone numbers, no '+'.

whatsapp_update_group_participantsC

Add or remove group participants. action: 'add'|'remove'. participants: phone list, no '+'.

whatsapp_get_group_invite_linkB

Get invite link for a group. group_jid: group identifier.

whatsapp_adminB

WuzAPI admin operations. action: 'list_users'|'create_user'|'delete_user'|'enable_history'. Requires admin token.

whatsapp_configureC

Save WuzAPI credentials. Run once to set up. token: user token. admin_token: optional, for admin tools.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/gabriellopesdesouza2002/mcp-whatsapp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server