Gws Gmail Triage
- 37.6k installs
- 30.2k repo stars
- Updated August 1, 2026
- googleworkspace/cli
gws gmail triage is a Google Workspace CLI skill for viewing unread inbox summaries with sender, subject, and date information.
About
gws gmail triage is a Google Workspace CLI skill for quickly viewing unread inbox messages as a summary table. Use it when developers need to review email metadata, automate email triage, or integrate Gmail status into workflows. It is read-only and supports custom queries and output formats.
- Show unread inbox summary (sender, subject, date) with a single command
- Filter messages with Gmail search queries (e.g., from:boss)
- Control output with --max and --format flags (table, json)
Gws Gmail Triage by the numbers
- 37,592 all-time installs (skills.sh)
- +587 installs in the week ending Aug 5, 2026 (Skillselion tracking)
- Ranked #23 of 688 Office & Documents skills by installs in the Skillselion catalog
- Security screen: LOW risk (skills.sh audit)
- Data as of Aug 5, 2026 (Skillselion catalog sync)
gws-gmail-triage capabilities & compatibility
- Capabilities
- email triage · data read
- Works with
- gmail
What gws-gmail-triage says it does
Show unread inbox summary (sender, subject, date)
npx skills add https://github.com/googleworkspace/cli --skill gws-gmail-triageAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 37.6k |
|---|---|
| repo stars | ★ 30.2k |
| Security audit | 3 / 3 scanners passed |
| Last updated | August 1, 2026 |
| Repository | googleworkspace/cli ↗ |
How do you summarize unread Gmail from terminal?
View and triage unread emails from the command line.
Who is it for?
Developers integrating Gmail into workflows or managing email from the command line.
Skip if: Teams needing full Gmail compose, reply, or label management beyond unread summaries.
When should I use this skill?
Reviewing unread emails, filtering messages, or automating email triage.
What you get
Terminal unread inbox summary with sender, subject, and date per message.
- Unread inbox summary table
By the numbers
- Version 0.22.5 skill in googleworkspace/cli
- Default --max 20 unread messages per triage run
- Requires gws binary per openclaw metadata
Files
gmail +triage
PREREQUISITE: Read../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
Show unread inbox summary (sender, subject, date)
Usage
gws gmail +triageFlags
| Flag | Required | Default | Description |
|---|---|---|---|
--max | — | 20 | Maximum messages to show (default: 20) |
--query | — | — | Gmail search query (default: is:unread) |
--labels | — | — | Include label names in output |
Examples
gws gmail +triage
gws gmail +triage --max 5 --query 'from:boss'
gws gmail +triage --format json | jq '.[].subject'
gws gmail +triage --labelsTips
- Read-only — never modifies your mailbox.
- Defaults to table output format.
See Also
- gws-shared — Global flags and auth
- gws-gmail — All send, read, and manage email commands
Related skills
Lark DocGenerate, update, and maintain structured documentation directly inside Lark/Feishu using natural language and agentic workflows.494kLark DriveLet their coding agents read, create, update and search documents stored in Lark (Feishu) Drive directly from prompts.493kLark SheetsConnect Claude, Cursor or other agents directly to Feishu/Lark spreadsheets for live data reads, writes, and structured automation.493kLark WikiGenerate, update, and sync structured knowledge bases inside Lark (Feishu) directly from code, specs, or agent output.493kLark WhiteboardGenerate, edit, and collaborate on visual diagrams and flowcharts directly inside Claude, Cursor or other agents.493kLark SlidesInstantly generate polished, professional slide decks from specs, roadmaps, or meeting notes using Lark/Feishu.493kHow it compares
Use gws-gmail-triage for fast unread snapshots; use fuller Gmail API integrations when you need send, reply, or label automation.
FAQ
What command does gws-gmail-triage run?
gws-gmail-triage executes gws gmail +triage, which prints unread inbox rows with sender, subject, and date. Use --max to change the default 20-message limit or --query for Gmail search filters.
What does gws-gmail-triage require?
gws-gmail-triage requires the gws binary installed and authenticated per gws-shared/SKILL.md. If shared auth guidance is missing, run gws generate-skills to regenerate prerequisite skills.
How many emails does gws-gmail-triage show by default?
gws-gmail-triage shows up to 20 unread messages by default via the --max flag default. Increase or decrease the limit or pass a Gmail --query to narrow results.
Is Gws Gmail Triage safe to install?
skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.