gws-gmail-triage

List unread Gmail messages with sender, subject, and date.

2|1|Updated Jan 31, 2014
One-click install
npx skills add https://github.com/mattforni/homebase --skill gws-gmail-triage-mattforni
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gws-gmail-triage
Source: https://github.com/mattforni/homebase/tree/main/.claude/skills/gws-gmail-triage
Command: npx skills add https://github.com/mattforni/homebase --skill gws-gmail-triage-mattforni

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Quickly surface unread Gmail messages by presenting a concise summary with sender, subject, and date, saving time from opening each thread.

Core Features & Use Cases

  • Unread inbox summary: lists sender, subject, and date for unread messages (configurable with --max).
  • Configurable filters: supports --query to narrow results and --labels to include label names.
  • Read-only operation: never modifies mailbox; suitable for quick triage and status checks.

Quick Start

Ask gws to show unread Gmail messages.

Frequently Asked Questions about gws-gmail-triage

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I summarize unread Gmail messages without opening each thread?

To summarize unread Gmail messages, this Skill reads inbox metadata and outputs a concise list of sender, subject, and date. It provides a quick triage view so you can scan unread emails without opening individual threads.

Can I filter my unread Gmail inbox summary by label or search query?

Yes, you can filter your unread Gmail inbox summary using the --query flag to narrow search results and the --labels flag to include specific label names. This allows targeted triage across diverse Gmail configurations.

Does this Gmail triage tool modify or delete my inbox emails?

No, this Gmail triage tool operates as a read-only operation that never modifies your mailbox. It only reads message metadata to output a formatted list, making it safe for quick status checks.

What's the best way to limit the number of unread emails shown in my Gmail summary?

The best way to limit unread emails shown in your Gmail summary is by applying the --max flag. This configures the maximum number of unread messages the Skill reads and outputs in the formatted list.

What information is included in an unread Gmail inbox summary?

An unread Gmail inbox summary includes the sender, subject, and date for each message. It reads this metadata to produce a clear, formatted list designed for quick inbox checks and label-filtered reviews.