AutoGineer
Generated banner for Gws Gmail Triage
Generated logo for Gws Gmail Triage

Gws Gmail Triage

Google WorkspaceOfficialPublished by Google Workspace

  • Skill
  • Tool integration
  • Automation and integrations
  • Apache-2.0
  • No issues found
Download ZIP

From the author

Gmail: Show unread inbox summary (sender, subject, date).
— the description by Google Workspace

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

The gws-gmail-triage skill provides a streamlined way to view a summary of unread emails in your Gmail inbox. By interacting with the Gmail API through the gws command-line interface, it extracts key details such as the sender, subject line, and date for quick review. The tool is designed to be read-only, ensuring that your mailbox remains untouched while you triage your incoming communications.

What it does

  • Lists unread messages from your Gmail inbox.
  • Displays sender, subject, and date information for each email.
  • Supports custom search queries to filter specific messages.
  • Allows limiting the number of results returned.
  • Provides optional inclusion of email labels in the output.
  • Supports JSON output for integration with other command-line tools.

When to use it

  • When you need a quick overview of unread emails without opening a browser.
  • When you want to filter your inbox by specific criteria like sender or keywords.
  • When you need to pipe email metadata into other scripts or tools.
  • When you want to perform a safe, read-only audit of your inbox status.

Advantages

  • Fast and efficient access to inbox summaries.
  • Read-only operation prevents accidental modifications.
  • Flexible filtering options via standard Gmail search queries.
  • Command-line native for seamless integration into developer workflows.

Usage examples

“Show me my latest unread emails.”
The agent executes the triage command to display a table of the most recent unread messages including sender, subject, and date.
“Find unread emails from my boss.”
The agent runs the triage command with a custom query filter to isolate and display relevant unread messages.
“List the subjects of my last 5 unread emails.”
The agent uses the max flag and pipes the JSON output to a processor to extract and list only the subject lines.

Install

  1. Download the skill as a ZIP:

    https://autogineer.com/agent-skills/googleworkspace/gws-gmail-triage/download

  2. Unzip it into the cross-client skills folder of your project:

    mkdir -p .agents/skills && unzip gws-gmail-triage.zip -d .agents/skills

Documentation by Google Workspace

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
--max—20Maximum 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

Files

Requirements and compatibility

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Security

No issues found by our static scan· No issues found

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Attribution and licence

Published by
Google Workspace
Publisher
Google Workspace (Official)
Source
googleworkspace/cli · skills/gws-gmail-triage · commit cd3697e
Licence
Apache License 2.0 (redistribution allowed)
  • LICENSE (added by AutoGineer from LICENSE)
  • ATTRIBUTION.md (written by AutoGineer)
Synced

AutoGineer is not affiliated with or endorsed by Google Workspace or Google Workspace.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download gws-gmail-triage.zip