Gws Gmail Triage
googleworkspace/cliOfficial
A read-only Gmail triage tool that pulls your unread messages and displays sender, subject, and date in a clean table format. Perfect for those daily inbox check-ins when you need to quickly scan what's waiting without getting sucked into actually reading emails. The query flag lets you filter down to specific senders or topics, and it caps at 20 messages by default so you don't get overwhelmed. It's built on the gws toolkit, so you'll need that set up with Gmail API access first. Honestly beats opening Gmail in the browser when you just want a quick pulse check on what's urgent.
- installs
- 47K
- GitHub stars
- 31.9K
- last updated
- Aug 21, 2026
Install
$ npx -y skills add googleworkspace/cli --skill gws-gmail-triage --agent claude-codeInstalls into .claude/skills of the current project.
Files
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
Sponsors
Details
- Repository
- github.com/googleworkspace/cli
- Categories
- CLI & Terminal, Office & Documents
