Skip to main content
Glama
kalki-kgp

WhatsApp MCP for macOS

by kalki-kgp

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault

No arguments

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_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:

  1. First use whatsapp_status to ensure WhatsApp is connected.

  2. Use whatsapp_search_contacts to get the correct JID.

  3. Always confirm with the user before sending.

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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription
resource_statusCurrent WhatsApp connection status.
resource_unreadSummary of unread WhatsApp messages.
resource_chatsRecent 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