gws-gmail-triage
Lets your agent show a summary of the inbox with unread emails. Helps get a quick overview of what's important.
What it does
This command shows a summary of your unread emails. It displays who sent the email, the subject, and the date.
When to use it
- ✓When you want to quickly see which important emails have arrived.
- ✓To get an idea of what needs to be read without opening each email.
- ✓If you have many emails and want to focus on the unread ones.
Example of what to ask your AI
“Show my unread emails.”
Want more? Open the sections below.
How to use
The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.
Skill link
Ready-to-paste message
How it works
It accesses your Gmail inbox and searches for emails that haven't been opened yet. Then, it displays the main information for each one.
Installation
Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.
In the terminal (Claude Code, Codex, Cursor), in your project folder:
npx skills add googleworkspace/cli --skill gws-gmail-triageOr download just the file:
curl -L https://raw.githubusercontent.com/googleworkspace/cli/main/skills/gws-gmail-triage/SKILL.md -o SKILL.mdTechnical content (original SKILL.md)
Original text by the author, straight from GitHub.
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
FAQ
Can I see more or fewer emails?
Yes, you can use the '--max' option followed by a number to set how many emails you want to see.
Can I search for specific emails?
Yes, you can use the '--query' option with Gmail search terms, like 'from:boss' to see emails only from your boss.
Does this command change my emails?
No, it only reads and displays information. Your emails are not modified.
Details
Original description by the author
Gmail: Show unread inbox summary (sender, subject, date).
repo: googleworkspace/cli
Popularity
- GitHub stars
- 32k
- Ranking position
- #6270
- License
- Apache-2.0
- Updated
- 10/6/2026
Comments
- …
More skills from this repository
gws-admin-reports
Helps your agent get activity reports from Google Workspace. It collects audit and usage data.
googleworkspace/cli
gws-calendar-agenda
Helps your agent see upcoming events across all calendars. It's useful for organizing your schedule and knowing what's coming up.
googleworkspace/cli
gws-calendar-insert
Lets your agent create new events in Google Calendar. It's useful for scheduling appointments and meetings.
googleworkspace/cli
gws-calendar
Allows your agent to manage calendars and events. It's useful for organizing your life and work.
googleworkspace/cli
Similar skills
google-workspace-ops
Operates with Google Workspace documents (Drive, Docs, Sheets, Slides) as a unified workflow. It makes it easy to find, summarize, and edit your files without leaving the tool.
affaan-m/ECC
Dynamics 365 Automation
Helps your agent manage customer information in Dynamics 365. It can handle contacts, sales, and cases, making work more organized.
ComposioHQ/awesome-claude-skills
Excel Automation
Helps your agent work with spreadsheets in Excel and Google Sheets. It can create, edit, and format files.
ComposioHQ/awesome-claude-skills