agent-whatsapp

Manage WhatsApp chats via CLI with JSON output and QR authentication.

170|25|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/agent-messenger/agent-messenger --skill agent-whatsapp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-whatsapp
Source: https://github.com/agent-messenger/agent-messenger/tree/main/skills/agent-whatsapp
Command: npx skills add https://github.com/agent-messenger/agent-messenger --skill agent-whatsapp

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

AI agents can interact with WhatsApp via a CLI to send, read, and manage chats, eliminating the need for UI toggles or manual steps and enabling automation.

Core Features & Use Cases

  • QR and pairing login: Authenticate as a companion device so phones stay linked without exposing credentials or tokens.
  • Send, read, and react: Send messages, list chats, read histories, and react to messages across individual and group chats.
  • Multi-account support: Link and switch between multiple WhatsApp numbers with per-command account selection.
  • JSON-first output: Default JSON, with a --pretty option for human-readable formatting, suitable for AI consumption.
  • On-demand connections: Each command opens a WebSocket session and closes it after completion to minimize background activity.
  • Reference material available: Contextual references describe authentication, usage patterns, and troubleshooting.

Quick Start

Install the agent-messenger package and run agent-whatsapp to begin linking your account.

Frequently Asked Questions about agent-whatsapp

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate sending WhatsApp messages from a CLI?

You can automate sending WhatsApp messages from a CLI by using AI agents to issue chat commands, eliminating manual UI steps. The Skill opens an on-demand WebSocket session to execute actions and outputs JSON by default for AI processing.

Can I manage multiple WhatsApp accounts through the same CLI tool?

Yes, you can manage multiple WhatsApp accounts through the same CLI tool. It supports linking and switching between multiple WhatsApp numbers with per-command account selection for both individual and group chats.

How does WhatsApp CLI authentication work for AI agents?

WhatsApp CLI authentication works by linking as a companion device via QR code or pairing. This on-demand connection model keeps phones linked without exposing credentials or tokens, closing the session after each command completes.

Is there a way to read and react to WhatsApp chat histories programmatically?

Yes, you can read and react to WhatsApp chat histories programmatically. The CLI enables AI agents to list chats, read message histories, and send reactions across both DM and group chats, returning structured JSON data.

Does the WhatsApp messaging automation tool output JSON for AI consumption?

Yes, the WhatsApp messaging automation tool outputs JSON by default for AI consumption. It also includes a --pretty option if you need human-readable formatting for troubleshooting or direct terminal review.

When should I not use an on-demand connection model for WhatsApp automation?

You should not use an on-demand connection model for WhatsApp automation if your workflow requires persistent background listening. Each command opens a WebSocket session and closes it immediately after completion to minimize background activity.