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
Send, read, and manage Gmail emails via Google Workspace CLI.
gws-drive
Manage Google Drive files, folders, and shared drives via CLI.
gws-docs
Read and write Google Docs via command line.
gws-calendar
Manage Google Calendar events, calendars, and access control via CLI.
gws-sheets
Read and write Google Sheets spreadsheets via CLI.
gws-gmail-send
Send emails via Gmail with attachments, CC/BCC, HTML support, and draft options.