whatsapp-hermes
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 | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| whatsapp_statusA | Get the WhatsApp connection status: whether connected, whether pairing (QR scan) is needed, the bot's own JID, and how many messages are buffered. |
| whatsapp_sendA | Send a WhatsApp text message. 'to' may be a raw phone number (digits, country code, no +) or a full JID (…@s.whatsapp.net for a person, …@g.us for a group). |
| whatsapp_send_imageA | Send an image from a local absolute file path. The file must exist and be a valid image (jpg, png, gif, webp, etc.). |
| whatsapp_list_chatsA | List recent chats seen since the server started, newest first, with the last message preview. |
| whatsapp_get_messagesA | Get buffered incoming messages, newest first. Optionally filter by chatId and/or a 'since' epoch-ms timestamp, and cap with 'limit'. |
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 5 tools
Each tool addresses a distinct concern: connection status, sending text, sending images, listing chats, and retrieving messages. There is no overlap in purpose, so an agent can reliably select the correct tool for a given task.
Tool names uniformly use the whatsapp_ prefix and mostly follow a verb_noun pattern (whatsapp_send, whatsapp_list_chats, whatsapp_get_messages). The only exception is whatsapp_status, which could be interpreted as a status check rather than a verb action, but the pattern is otherwise predictable.
Five tools is well-scoped for a WhatsApp bot server: covering status, messaging, and chat listing without unnecessary bloat. Each tool has a clear role and none are redundant.
The set covers core lifecycle needs: check connectivity, send text, send images, list chats, and read incoming messages. Minor gaps exist, such as sending other media types or marking messages as read, but these are not critical for typical usage.