gws-gmail-triage

Fetch unread Gmail messages and summarize sender, subject, and date.

8|1|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/niclasmartinsson-sys/google-workspace-cli --skill gws-gmail-triage-niclasmartinsson-sys
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gws-gmail-triage
Source: https://github.com/niclasmartinsson-sys/google-workspace-cli/tree/main/skills/gws-gmail-triage
Command: npx skills add https://github.com/niclasmartinsson-sys/google-workspace-cli --skill gws-gmail-triage-niclasmartinsson-sys

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Quickly understand Gmail workload by showing a concise summary of unread messages, including who sent them, the subject, and when they arrived.

Core Features & Use Cases

  • Unread message summary: displays sender, subject, and date for quick inbox triage.
  • Configurable max results: limit how many messages are shown to fit your workflow.
  • Optional labels: include label names to contextualize messages.

Quick Start

Run gws gmail +triage to display the unread inbox summary.

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 for quick inbox triage?

To summarize unread Gmail messages for inbox triage, the Skill fetches unread emails via the Gmail API and presents a concise list showing the sender, subject, and date for each message. This allows you to quickly scan and prioritize responses without opening individual threads.

Can I limit the number of unread emails included in the Gmail summary?

Yes, you can limit the number of unread emails in the Gmail summary by configuring the max results setting. This restricts the output to a specific number of messages, helping you manage a bounded workload during each triage session.

Does the Gmail triage summary support filtering by inbox labels?

Yes, the Gmail triage summary supports filtering by labels. You can include optional label names in the configuration to contextualize the unread messages, allowing you to focus on specific categories or folders within your inbox during the triage process.

What do I need to authenticate the Gmail API for fetching unread inbox messages?

You need existing authentication credentials to fetch unread inbox messages. The Skill relies on pre-configured authentication to access the Gmail API, meaning you must already be authenticated in your environment before running the inbox triage command.

What is the best way to scan unread emails across different Gmail labels?

The best way to scan unread emails across different Gmail labels is to use an automated triage skill that applies label filters to the Gmail API request. This outputs a structured summary of sender, subject, and date details, helping you prioritize responses across categories.