gws-gmail

Manage Gmail messages and mailbox workflows through the gws command-line interface.

9|Updated Jun 11, 2026
One-click install
npx skills add https://github.com/llm011/ethan-agent --skill gws-gmail-llm011
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gws-gmail
Source: https://github.com/llm011/ethan-agent/tree/main/ethan/defaults/skills/gws-gmail
Command: npx skills add https://github.com/llm011/ethan-agent --skill gws-gmail-llm011

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill simplifies Gmail and Google Workspace email operations by providing reliable command-line workflows for reading, sending, replying to, forwarding, organizing, and monitoring messages.

Core Features & Use Cases

  • Email Management: Send, read, reply to, reply-all, and forward Gmail messages through the gws CLI.
  • Inbox Triage and Organization: Summarize unread messages, search mail, apply labels, archive messages, and manage drafts.
  • Monitoring and Automation: Watch for new messages through Gmail push notifications, perform incremental checks, and save attachments to Google Drive.
  • Safety Controls: Treat email content as untrusted input, require confirmation before sending or forwarding, preview destructive batch actions, and use only IDs obtained from real Gmail queries.

Quick Start

Ask the gws-gmail skill to summarize your unread Gmail messages, and then draft a reply to a selected message for your approval.

Frequently Asked Questions about gws-gmail

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

FAQPage Schema
How do I automate Gmail inbox triage and organize unread messages?

Automate Gmail inbox triage by using command-line workflows to summarize unread messages, search mail, apply labels, and archive messages. This approach enables rapid organization of incoming email directly through terminal commands.

Can I send and reply to Gmail messages from the command line?

Yes, you can send, reply, reply-all, and forward Gmail messages from the command line. The workflow requires confirmation safeguards before executing outbound operations to ensure email actions are intentional and safe.

Do I need Google Workspace CLI access to monitor Gmail with push notifications?

Yes, monitoring Gmail with push notifications requires authenticated Google Workspace access and the gws CLI. You can watch for new messages through PubSub watches and perform incremental checks for new mail.

What is the best way to handle Gmail attachments and save them to Google Drive?

Handle Gmail attachments by using command-line workflows that save attachments directly to Google Drive. This integrates email management with cloud storage, enabling automated attachment-handling workflows.

Are there safety controls for destructive Gmail batch actions?

Yes, safety controls include previewing destructive batch actions before execution and treating email content as untrusted input. The system uses only IDs obtained from real Gmail queries to prevent accidental data loss.

How do I draft a Gmail reply for approval before sending?

Draft a Gmail reply for approval by asking the skill to summarize unread messages and generate a reply draft. The generated draft waits for your explicit confirmation before the outbound email is sent.