gws-gmail-triage
googleworkspace/cli
Quickly view your unread Gmail inbox with sender, subject, and date.
What is gws-gmail-triage?
This skill displays a summary of unread messages in your Gmail inbox, showing sender, subject, and date for each message. Use it to triage incoming emails and stay on top of your inbox without opening Gmail.
- Display unread messages with sender, subject, and date
- Limit results with --max flag (default 20 messages)
- Filter messages using Gmail search queries via --query flag
- Include label names in output with --labels flag
- Output in table or JSON format for easy parsing
How to install gws-gmail-triage
npx skills add null --skill gws-gmail-triage- Google Workspace CLI (gws) installed
- Authentication configured via gws-shared skill
- Read access to Gmail account
How to use gws-gmail-triage
- 1.Run `gws gmail +triage` to display your 20 most recent unread messages
- 2.Use `--max N` to change the number of messages shown
- 3.Use `--query 'search terms'` to filter by Gmail search syntax (e.g., `from:boss`)
- 4.Add `--labels` flag to include label names in the output
- 5.Pipe to `jq` or other tools when using `--format json` for further processing
Use cases
- Quick morning inbox check to see what needs attention
- Filter unread emails from a specific sender using custom queries
- Export unread message subjects to JSON for processing by other tools
- Review inbox status without opening the Gmail web interface
- Email power users managing high-volume inboxes
- Developers automating email workflows
- Anyone wanting a command-line inbox summary
gws-gmail-triage FAQ
No, it is read-only and never modifies your emails or mailbox.
By default, it shows messages matching `is:unread`. You can override this with the --query flag.
Yes, use `--query 'from:sender@example.com'` to filter emails from a specific sender.
Table format is the default. Use `--format json` to output as JSON for scripting.
Full instructions (SKILL.md)
Source of truth, from googleworkspace/cli.
name: gws-gmail-triage description: "Gmail: Show unread inbox summary (sender, subject, date)." metadata: version: 0.22.5 openclaw: category: "productivity" requires: bins: - gws cliHelp: "gws gmail +triage --help"
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
Related skills
More from googleworkspace/cli and the wider catalog.
gws-gmail-watch
Watch Gmail for new emails and stream them as NDJSON in real-time.
gws-groupssettings
Manage Google Groups settings.
gws-keep
Manage Google Keep notes via CLI with create, delete, get, list, and permission operations.
gws-meet
Manage Google Meet conferences via CLI—query records, spaces, participants, and transcripts.
gws-modelarmor
Filter user-generated content for safety using Google Model Armor templates.
gws-modelarmor-create-template
Create Google Model Armor templates to protect AI models from jailbreak and safety attacks.