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.