Gws Gmail Triage

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.

skills.sh installs: 48.2K
GitHub stars: 32.2K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add googleworkspace/cli --skill gws-gmail-triage --agent claude-code

Installs into .claude/skills of the current project.

Files

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.

Details

Repository: github.com/googleworkspace/cli
Categories: CLI & Terminal, Office & Documents