whatsapp-assistant-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
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
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_chatsA | Lists the WhatsApp chats this server may touch: jid, display name, whether sending is allowed (canPost), and a lightweight recent-activity count. Never lists any other chat. |
| read_chat_messagesA | Reads the last N stored messages for one allowlisted chat, oldest first. Messages come from the local inbox log, not a live WhatsApp fetch, so this works even when WhatsApp is briefly unreachable. |
| send_chat_messageA | Sends a text message to an allowlisted chat that has canPost enabled. Handed off to the background daemon -- the only process holding the WhatsApp connection -- and waits up to 15s for delivery confirmation. Real people read this immediately; it cannot be unsent. |
| poll_chatsA | Drains messages that arrived since the last poll_chats call, grouped by chat jid. The read position is persisted, so each message is returned exactly once across calls. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose: listing chats, reading stored message history, sending a new message, and polling for newly arrived messages. The one potential overlap between read_chat_messages and poll_chats is resolved by their explicit focus on historical versus incremental messages.
All four tool names follow the same verb_noun snake_case pattern: list_chats, read_chat_messages, send_chat_message, and poll_chats. There are no mixed conventions or inconsistent verb styles.
Four tools is a well-scoped size for a WhatsApp assistant: list, read, send, and poll cover the core needs without unnecessary redundancy. Each tool earns its place.
The toolset covers the main assistant workflow: discovering conversations, reading previous messages, sending replies, and receiving new messages. It lacks richer operations like media sending, message search, or read receipts, but those are reasonable omissions for this focused server.