googleworkspace avatar

Gws Gmail Triage

googleworkspace/cli
20.2k

This skill allows users to quickly view a summary of unread Gmail messages, displaying sender, subject, and date, without modifying the mailbox. It is ideal for productivity and email triage, offering customizable options such as maximum message count and search queries. Suitable for both individuals and automation, it provides read-only access with simple command-line usage.

npx skills add https://github.com/googleworkspace/cli --skill gws-gmail-triage

gmail +triage

PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to 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

GitHub Owner

Owner: googleworkspace

Files

gws-shared

gws-gmail

SKILL.md


name: gws-gmail-triage version: 1.0.0 description: "Gmail: Show unread inbox summary (sender, subject, date)." metadata: openclaw: category: "productivity" requires: bins: ["gws"] cliHelp: "gws gmail +triage --help"

gmail +triage

PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to create it. Show unread inbox summary (sender, subject, date)

Usage

gws gmail +triage

Flags

FlagRequiredDefaultDescription
--max20Maximum messages to show (default: 20)
--queryGmail search query (default: is:unread)
--labelsInclude 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

More skills