Skip to content
Get packs

Gmail Unread Triage

Lists your unread Gmail messages as a quick sender, subject and date summary via the gws CLI.

Source Download skill
Repository
googleworkspace/cli
Stars
32,059
Licence
Apache-2.0
Files
1 file

What it does

Once installed, the agent can run the gws command-line tool to pull a short list of your unread Gmail messages, showing who sent each one, the subject and the date. You can narrow the list with a Gmail search query, limit how many items appear, or include label names. The skill states it is read-only and does not change your mailbox.

Great for

  • People with a busy inbox who want a fast overview of unread mail
  • Developers who want Gmail summaries piped into scripts as JSON
  • Anyone already using the gws Google Workspace CLI

Skip it if

  • Users who need to send, reply to, or organize email, since this skill only reads summaries (the related gws-gmail skill covers those actions)
  • Setups without the gws tool installed and authenticated, because the skill cannot run without it
  • Sensitive mailboxes where the agent should not read message metadata at all

Try asking

  • “Show me my unread emails from today”
  • “Give me a summary of the 5 newest unread messages from my boss”
  • “List unread mail with label names included”
  • “Summarize unread inbox items as JSON so I can filter the subjects”
Step-by-step guide: how to use Gmail Unread TriageInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the Apache-2.0 licence and an attribution note.

    gws-gmail-triage.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

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

    Claude Code / Agent SDK (this project only)

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

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Use --query with Gmail search syntax, such as 'from:name' or 'newer_than:2d', to focus the summary.
  • Run gws generate-skills first if the shared authentication skill is missing.
  • Pipe JSON output to jq when you want to process results in a script.

What's inside

  • SKILL.md

Redistributed unmodified from googleworkspace/cli under the Apache-2.0 licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.