mcp-wacli
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": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_chatsB | List WhatsApp chats from local DB. |
| show_chatB | Show details of a single chat. |
| list_messagesB | List recent WhatsApp messages with optional filters. |
| search_messagesA | Full-text search across WhatsApp messages (FTS5 if available, LIKE fallback). |
| show_messageC | Show details of a single message. |
| message_contextA | Show surrounding messages around a specific message ID for context. |
| search_contactsB | Search WhatsApp contacts by name or phone number. |
| show_contactC | Show details of a single contact. |
| set_contact_aliasA | Set a local alias (nickname) for a contact. |
| remove_contact_aliasC | Remove a local alias from a contact. |
| refresh_contactsB | Import/refresh contacts from the WhatsApp session store into local DB. |
| send_messageB | Send a text message via WhatsApp. |
| send_fileA | Send a file (image, video, audio, document) via WhatsApp. |
| list_groupsB | List WhatsApp groups from local DB. |
| group_infoB | Fetch live group info from WhatsApp and update local DB. |
| group_renameC | Rename a WhatsApp group. |
| group_leaveC | Leave a WhatsApp group. |
| group_joinA | Join a WhatsApp group by invite code. |
| group_participants_addC | Add participants to a WhatsApp group. |
| group_participants_removeB | Remove participants from a WhatsApp group. |
| group_participants_promoteB | Promote participants to admin in a WhatsApp group. |
| group_participants_demoteA | Demote admin participants in a WhatsApp group. |
| download_mediaB | Download media from a WhatsApp message. |
| sync_onceA | Sync messages once (connect, fetch new messages, then exit). |
| history_backfillC | Request older messages for a chat from your primary device (best-effort). |
| doctorB | Run wacli diagnostics — check store, authentication, and search capabilities. |
| auth_statusA | Show authentication status of the current wacli session. |
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 27 tools
Most tools have distinct purposes, but there is some overlap between list_chats and list_groups (both list entities), and between search_messages and list_messages (both retrieve messages). The descriptions clarify the differences, but an agent might occasionally confuse them.
Tool names follow a consistent snake_case pattern with clear verb_noun structures (e.g., download_media, group_leave, search_contacts). There are no deviations in naming conventions across all 27 tools.
With 27 tools, the count feels heavy for a WhatsApp CLI toolset. While it covers many features, it borders on being overwhelming and could be streamlined without losing core functionality.
The toolset provides comprehensive coverage for WhatsApp operations, including authentication, messaging, group management, contact handling, media, and syncing. There are no obvious gaps; it supports full CRUD-like workflows for the domain.