WhatsApp MCP for macOS
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| whatsapp_statusA | Check WhatsApp connection status. Returns current status: 'connected', 'qr_pending', 'disconnected', or 'bridge_offline'. If QR code is needed, returns a data URL you can open in a browser to scan. Call this before sending messages to ensure WhatsApp is connected. |
| whatsapp_search_contactsA | Search WhatsApp contacts by name or phone number. Returns matching contacts with their JID, display name, and phone number. Use this to find a contact before reading their messages or sending them a message. Args: query: Name or phone number to search for (partial match supported). |
| whatsapp_list_chatsA | List recent WhatsApp chats ordered by last message time. Args: limit: Number of chats to return (max 50). chat_type: Filter by 'dm', 'group', or 'all'. |
| whatsapp_get_messagesA | Get messages from a specific WhatsApp chat. Args: chat_jid: JID of the chat (from whatsapp_search_contacts or whatsapp_list_chats). after: Only messages after this datetime (ISO 8601). Defaults to 24h ago. before: Only messages before this datetime (ISO 8601). Defaults to now. limit: Max messages to return (max 200). search_text: Optional text to filter messages. |
| whatsapp_search_messagesA | Search for messages containing specific text across all chats. Args: query: Text to search for (case-insensitive). chat_jid: Optional - restrict search to a specific chat. limit: Max results (max 50). |
| whatsapp_unreadA | Get a summary of all unread WhatsApp messages. Returns chats with unread messages and recent message previews. Great for "catch me up" or "what did I miss" requests. |
| whatsapp_sendA | Send a WhatsApp message. IMPORTANT:
Args: recipient_jid: The JID from whatsapp_search_contacts. message: The text message to send. |
| whatsapp_incomingA | Get recent incoming WhatsApp messages from the live connection. These are real-time messages, not from the local database. Useful for checking new messages that just arrived. Args: since_minutes: Look back N minutes (default 5, max 60). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| resource_status | Current WhatsApp connection status. |
| resource_unread | Summary of unread WhatsApp messages. |
| resource_chats | Recent WhatsApp chats. |
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/kalki-kgp/whatsapp-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server