gws-gmail-triage▌
googleworkspace/cli · updated Apr 8, 2026
Quickly summarize unread Gmail inbox messages with sender, subject, and date.
- ›Displays up to 20 unread messages by default; customize with --max flag
- ›Supports Gmail search queries via --query flag to filter beyond unread (e.g., from:boss )
- ›Read-only operation; never modifies your mailbox
- ›Optional --labels flag includes label names in output; supports JSON format for scripting
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 +triage
Flags
| 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 --labels
Tips
- 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
Discussion
Product Hunt–style comments (not star reviews)- No comments yet — start the thread.
Ratings
4.7★★★★★62 reviews- ★★★★★Amelia Singh· Dec 24, 2024
gws-gmail-triage has been reliable in day-to-day use. Documentation quality is above average for community skills.
- ★★★★★Benjamin Smith· Dec 20, 2024
I recommend gws-gmail-triage for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.
- ★★★★★Dhruvi Jain· Dec 16, 2024
gws-gmail-triage fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.
- ★★★★★Zaid Menon· Dec 12, 2024
We added gws-gmail-triage from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.
- ★★★★★Chen Johnson· Dec 8, 2024
Solid pick for teams standardizing on skills: gws-gmail-triage is focused, and the summary matches what you get after install.
- ★★★★★Isabella Malhotra· Dec 4, 2024
gws-gmail-triage reduced setup friction for our internal harness; good balance of opinion and flexibility.
- ★★★★★Zaid Johnson· Nov 23, 2024
Solid pick for teams standardizing on skills: gws-gmail-triage is focused, and the summary matches what you get after install.
- ★★★★★Li Ramirez· Nov 23, 2024
We added gws-gmail-triage from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.
- ★★★★★Isabella Srinivasan· Nov 19, 2024
gws-gmail-triage has been reliable in day-to-day use. Documentation quality is above average for community skills.
- ★★★★★Aisha Iyer· Nov 11, 2024
Keeps context tight: gws-gmail-triage is the kind of skill you can hand to a new teammate without a long onboarding doc.
showing 1-10 of 62