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://mp-staging.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

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

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

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.

Download ZIP

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