gmail-triage

Automate Gmail inbox triage with OAuth credentials and dry runs.

Updated Mar 3, 2026
One-click install
npx skills add https://github.com/gabbifish/gmail-triage --skill gmail-triage
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gmail-triage
Source: https://github.com/gabbifish/gmail-triage/tree/main/skills/gmail-triage
Command: npx skills add https://github.com/gabbifish/gmail-triage --skill gmail-triage

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the process of triaging and organizing your Gmail inbox, reducing manual effort and ensuring important emails are handled efficiently.

Core Features & Use Cases

  • Automated Labeling and Archiving: Automatically labels and archives emails based on predefined rules (e.g., political mail, calendar reminders).
  • Interactive Triage: Provides an interactive workflow for handling remaining unread emails, allowing domain-specific actions like labeling, unsubscribing, or archiving.
  • Safe Dry Runs: Supports dry runs to preview actions without making any changes to your Gmail account.
  • Use Case: Automatically categorize and archive political newsletters, process calendar notifications, and then interactively decide how to handle emails from new senders, all while ensuring your inbox stays clean.

Quick Start

Use the gmail-triage skill to perform a safe dry run of your Gmail triage workflow.

Frequently Asked Questions about gmail-triage

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

FAQPage Schema
How do I automate Gmail inbox triage and archiving?

Automate Gmail triage by applying predefined rules to label and archive emails, process calendar reminders, and interactively manage unread messages based on sender domains. It requires Google API access and local credential files to execute automated archiving actions.

Can I preview Gmail labeling and archiving actions before applying them?

Yes, you can preview Gmail labeling and archiving actions using the safe dry run feature. This allows you to simulate the triage workflow and review automated sender-based actions without making any actual changes to your Gmail account.

Do I need OAuth credentials to automate email management with Google API?

Yes, OAuth credential management is required to automate email management with Google API. You must configure local credential and token files to grant the script access for executing domain-wide unsubscribes and message-level archiving.

What is the best way to automatically categorize and archive newsletters in Gmail?

Automatically categorize and archive newsletters by configuring triage rules for specific senders or political mail detection. The script processes these emails independently before initiating an interactive workflow to handle remaining unread messages.

Does the interactive triage workflow support domain-wide unsubscribes?

Yes, the interactive triage workflow supports domain-wide unsubscribes alongside message-level archiving and labeling. This allows you to perform sender-based actions to efficiently clean your inbox of unwanted recurring emails.

Why should I use a script for Gmail triage instead of standard inbox filters?

Using a script for Gmail triage provides interactive sender-based actions and political mail detection beyond standard static filters. It supports dynamic dry runs, domain-wide unsubscribes, and complex calendar reminder processing to ensure important emails are handled efficiently.