Gws Gmail
- 66.2k installs
- 30k repo stars
- Updated July 22, 2026
- googleworkspace/cli
Gmail CLI is a skill for programmatic email operations via Gmail API through the gws command-line interface.
About
Programmatic email operations via Gmail API through gws CLI. Provides send, read, reply, forward, and watch capabilities. Developers use this to automate email workflows and integrate Gmail into agent applications.
- Send, read, reply, forward operations
- Stream new emails as NDJSON
- Full thread and message management
Gws Gmail by the numbers
- 66,225 all-time installs (skills.sh)
- +2,541 installs in the week ending Jul 28, 2026 (Skillselion tracking)
- Ranked #15 of 690 Office & Documents skills by installs in the Skillselion catalog
- Security screen: MEDIUM risk (skills.sh audit)
- Data as of Jul 28, 2026 (Skillselion catalog sync)
gws-gmail capabilities & compatibility
- Works with
- gmail
What gws-gmail says it does
Send, read, and manage email
Watch for new emails and stream them as NDJSON
npx skills add https://github.com/googleworkspace/cli --skill gws-gmailAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 66.2k |
|---|---|
| repo stars | ★ 30k |
| Security audit | 2 / 3 scanners passed |
| Last updated | July 22, 2026 |
| Repository | googleworkspace/cli ↗ |
How do you send and triage Gmail from the terminal?
Automating email workflows and integrating Gmail with agents
Who is it for?
Email automation, agent integration, workflow triggers
Skip if: Email client replacement, UI email applications
When should I use this skill?
A developer or agent needs to send status email, summarize unread Gmail, reply to a thread, or watch for new mail via `gws gmail`.
What you get
Sent messages, inbox triage summaries, reply drafts, and Gmail API responses returned as structured CLI output.
- sent emails
- inbox triage summaries
- gmail api cli responses
By the numbers
- Skill metadata version 0.22.5
- Documents 3 helper commands: +send, +triage, +reply
- Targets Gmail API v1
Files
gmail (v1)
PREREQUISITE: Read../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
gws gmail <resource> <method> [flags]Helper Commands
| Command | Description |
|---|---|
| `+send` | Send an email |
| `+triage` | Show unread inbox summary (sender, subject, date) |
| `+reply` | Reply to a message (handles threading automatically) |
| `+reply-all` | Reply-all to a message (handles threading automatically) |
| `+forward` | Forward a message to new recipients |
| `+read` | Read a message and extract its body or headers |
| `+watch` | Watch for new emails and stream them as NDJSON |
API Resources
users
getProfile— Gets the current user's Gmail profile.stop— Stop receiving push notifications for the given user mailbox.watch— Set up or update a push notification watch on the given user mailbox.drafts— Operations on the 'drafts' resourcehistory— Operations on the 'history' resourcelabels— Operations on the 'labels' resourcemessages— Operations on the 'messages' resourcesettings— Operations on the 'settings' resourcethreads— Operations on the 'threads' resource
Discovering Commands
Before calling any API method, inspect it:
# Browse resources and methods
gws gmail --help
# Inspect a method's required params, types, and defaults
gws schema gmail.<resource>.<method>Use gws schema output to build your --params and --json flags.
Related skills
Lark DocGenerate, update, and maintain structured documentation directly inside Lark/Feishu using natural language and agentic workflows.475kLark DriveLet their coding agents read, create, update and search documents stored in Lark (Feishu) Drive directly from prompts.475kLark SheetsConnect Claude, Cursor or other agents directly to Feishu/Lark spreadsheets for live data reads, writes, and structured automation.474kLark WikiGenerate, update, and sync structured knowledge bases inside Lark (Feishu) directly from code, specs, or agent output.474kLark WhiteboardGenerate, edit, and collaborate on visual diagrams and flowcharts directly inside Claude, Cursor or other agents.474kLark SlidesInstantly generate polished, professional slide decks from specs, roadmaps, or meeting notes using Lark/Feishu.474kForks & variants (1)
Gws Gmail has 1 known copy in the catalog totaling 6 installs. They canonicalize to this original listing.
- jetbrains - 6 installs
How it compares
Pick gws-gmail over generic email SDKs when you already standardize on the `gws` CLI and want agent-ready Gmail commands without writing OAuth flows.
FAQ
What CLI command sends email with gws-gmail?
gws-gmail documents the +send helper and `gws gmail` resource methods. Run `gws gmail +send` or consult `gws gmail --help` after installing the `gws` binary and completing gws-shared authentication.
What does gws gmail +triage return?
gws-gmail's +triage helper prints an unread inbox summary listing sender, subject, and date for each message. Agents use it to prioritize replies without opening the Gmail web UI.
Is Gws Gmail safe to install?
skills.sh reports 2 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.