gmail-organizer

Applies Gmail labels and archives categorized messages in batches to reach inbox zero.

Updated Apr 7, 2026
One-click install
npx skills add https://github.com/jay-stacey/claude-plugins --skill gmail-organizer-jay-stacey
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gmail-organizer
Source: https://github.com/jay-stacey/claude-plugins/tree/main/plugins/executive-assistant/skills/gmail-organizer
Command: npx skills add https://github.com/jay-stacey/claude-plugins --skill gmail-organizer-jay-stacey

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually labeling and archiving hundreds of categorized emails is slow and error-prone. This Skill takes the categorization output from an upstream email triage step and mechanically applies the correct Gmail labels, stars urgent items, and archives everything else so your inbox contains only what needs a response today. ## Core Features & Use Cases - Batch label operations: Groups messages by target label combination and uses batch_modify_gmail_message_labels instead of per-message loops, reducing API calls and execution time. - Hierarchical label management: Creates nested labels (Action/Urgent, FYI/Newsletters, Monitoring/Azure, Work/Jira, etc.) on first use and applies category-specific rules for starring and archiving. - Inbox-zero verification: Searches the inbox after processing, counts remaining items, and produces a structured report with per-label breakdowns and quick-access search queries. - Use Case: After a triage pass categorizes 200 unread emails into urgent, FYI, newsletter, and Jira buckets, run this Skill to label and archive all of them in a handful of batch calls, leaving only the 3 urgent starred messages in your inbox. ## Quick Start Apply labels and archive the categorized emails from the triage step, keeping urgent items starred in my inbox, then report whether inbox zero was achieved.

Frequently Asked Questions about gmail-organizer

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

FAQPage Schema
How do I apply Gmail labels to many emails at once?▼

Use batch_modify_gmail_message_labels with a list of message IDs and the labels to add or remove. Grouping messages by target label combination first lets you process hundreds of emails in a few API calls instead of looping per message.

How to reach inbox zero in Gmail automatically?▼

Categorize incoming mail, then label and archive everything except urgent items in batch operations. Verify the result by searching in:inbox and confirm only starred urgent messages remain.

Does this work with nested Gmail labels?▼

Yes, nested labels use a slash format like Action/Urgent or Monitoring/Azure. They are created on first use via manage_gmail_label with the create action if they do not already exist.

What happens if a batch label operation fails for some messages?▼

Per-message failures are logged with their message IDs and processing continues with the rest of the batch. The failed IDs are included in the final report rather than rolling back successful operations.

Can urgent emails be kept in the inbox while archiving everything else?▼

Yes, urgent messages receive the STARRED and Action/Urgent labels without removing the INBOX label. All other categories have INBOX removed after labeling, so only urgent items remain visible.