gws-gmail-triage

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

INSTALLATION
npx skills add https://github.com/googleworkspace/cli --skill gws-gmail-triage
Run in your project or agent environment. Adjust flags if your CLI version differs.

SKILL.md

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

  • gws-gmail — All send, read, and manage email commands
BrowserAct

Let your agent run on any real-world website

Bypass CAPTCHA & anti-bot for free. Start local, scale to cloud.

Explore BrowserAct Skills →

Stop writing automation&scrapers

Install the CLI. Run your first Skill in 30 seconds. Scale when you're ready.

Start free
free · no credit card