How do I install the Whatsapp Evo skill?

Run npx skillmds add tools-only/whatsapp-evo in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Whatsapp Evo skill do?

Manage WhatsApp via Evolution API (v2.x): list chats with unread messages and reply. It is listed under Integrations & APIs on SkillMD.

Is Whatsapp Evo safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Whatsapp Evo?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Whatsapp Evo free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Whatsapp Evo?

tools-only (@tools-only) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Whatsapp Evo by tools-only — Agent Skill

Name: Whatsapp Evo
Rating: 4.2 (5 reviews)
Author: tools-only

File contents

WhatsApp (Evolution API)

Requirements

Environment variables:
- EVOLUTION_API_URL (optional if config)
- EVOLUTION_API_TOKEN
- EVOLUTION_INSTANCE (optional if config)
Configure api_url and instance in ~/.config/skills/config.json under whatsapp_evo (recommended). The token must be set via env var.

Example:

{
  "whatsapp_evo": {
    "api_url": "https://evo.example.com",
    "instance": "MyInstance"
  }
}

Commands (from the skill folder)

1) Inbox (unread)

scripts/whatsapp-inbox --json-out /tmp/whatsapp-inbox.json

Shows a clean numbered list.
Saves metadata for later actions.
Note: the inbox is computed from the last incoming message without READ status in the API (it may not match "mark as unread" in the app).
Saves local state in ~/.cache/whatsapp-evo/inbox-state.json to avoid repeating chats (override with --state or WHATSAPP_EVO_STATE_PATH).
Use --no-update-state if you want to list the same chats again.
Use --since-days N to ignore old messages in the first pass (default 7).
Use --pending-reply to list conversations from the last N days where the latest message is not yours (ignores local state).

2) Reply (with user confirmation)

scripts/whatsapp-reply --index <n> --text "reply"

Replies to the chat at the given index using message/sendText.
For direct chats use the number; for groups use remote_jid if needed.
Optional: --delay <ms>, --link-preview, --instance, --url.

3) Conversation history

scripts/whatsapp-history --index <n> --limit 50

Use --jid or --number if you don’t have an index.
Filter by date with --since 2025-01-01 or --since 2025-01-01T10:00:00Z and --until.
Use --incoming-only to show only inbound messages.

Metadata format

/tmp/whatsapp-inbox.json contains:

index
name
remote_jid
number
unread_count
last_message_id
last_message_from_me
last_message_text
last_message_timestamp
last_message_sender

Rules

Show the user only the clean list; never show tokens.
Before replying, ask for confirmation.
If the JSON is stale or missing, re-run inbox.

---name: whatsapp-evodescription: Manage WhatsApp via Evolution API (v2.x): list chats with unread messages and reply.---# WhatsApp (Evolution API)## Requirements- Environment variables: - `EVOLUTION_API_URL` (optional if config) - `EVOLUTION_API_TOKEN` - `EVOLUTION_INSTANCE` (optional if config)- Configure `api_url` and `instance` in `~/.config/skills/config.json` under `whatsapp_evo` (recommended). The token must be set via env var.Example:```json{ "whatsapp_evo": { "api_url": "https://evo.example.com", "instance": "MyInstance" }}```## Commands (from the skill folder)### 1) Inbox (unread)```scripts/whatsapp-inbox --json-out /tmp/whatsapp-inbox.json```- Shows a clean numbered list.- Saves metadata for later actions.- Note: the inbox is computed from the last incoming message without `READ` status in the API (it may not match "mark as unread" in the app).- Saves local state in `~/.cache/whatsapp-evo/inbox-state.json` to avoid repeating chats (override with `--state` or `WHATSAPP_EVO_STATE_PATH`).- Use `--no-update-state` if you want to list the same chats again.- Use `--since-days N` to ignore old messages in the first pass (default 7).- Use `--pending-reply` to list conversations from the last N days where the latest message is not yours (ignores local state).### 2) Reply (with user confirmation)```scripts/whatsapp-reply --index <n> --text "reply"```- Replies to the chat at the given index using `message/sendText`.- For direct chats use the number; for groups use `remote_jid` if needed.- Optional: `--delay <ms>`, `--link-preview`, `--instance`, `--url`.### 3) Conversation history```scripts/whatsapp-history --index <n> --limit 50```- Use `--jid` or `--number` if you don’t have an index.- Filter by date with `--since 2025-01-01` or `--since 2025-01-01T10:00:00Z` and `--until`.- Use `--incoming-only` to show only inbound messages.## Metadata format`/tmp/whatsapp-inbox.json` contains:- `index`- `name`- `remote_jid`- `number`- `unread_count`- `last_message_id`- `last_message_from_me`- `last_message_text`- `last_message_timestamp`- `last_message_sender`## Rules- Show the user only the clean list; never show tokens.- Before replying, ask for confirmation.- If the JSON is stale or missing, re-run inbox.

Frequently asked questions