inbox-zero

Categorize, label, and archive Gmail messages to clear the inbox to zero.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Unread and unsorted email piles up in Gmail, making it hard to find priority messages and act on what matters. This Skill sweeps the inbox, categorizes mail by priority, applies labels, and archives processed messages so you reach inbox zero without manual triage. ## Core Features & Use Cases - Batch inbox sweep: Processes unread mail (or all inbox mail with --all), categorizes by priority, applies labels, and archives. - Safe preview mode: --dry-run reports the full plan without changing anything, and batch confirmation is required before labeling or archiving unless --auto-approve is set. - Flexible scope control: Flags like --quick, --labels-only, and --skip-newsletters let you tune how aggressive the cleanup pass is. - Use Case: After a weekend away, run a dry-run pass to see how 200 unread messages would be categorized, approve the plan, and return to an empty inbox with everything labeled. ## Quick Start Ask the assistant to run inbox zero on your Gmail with a dry run first, for example: clean up my Gmail inbox to zero but show me the plan before archiving anything.

Frequently Asked Questions about inbox-zero

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

FAQPage Schema
How do I clear my Gmail inbox to zero automatically?▼

Run the inbox-zero skill, which sweeps unread Gmail messages, categorizes them by priority, applies labels, and archives them. It shows a batch plan for approval before making any changes, and reports counts per category when finished.

How to preview Gmail cleanup changes before archiving?▼

Use the --dry-run flag to report the full categorization and archiving plan without changing anything. The dry-run flag overrides --auto-approve, so nothing is labeled or archived until you run without it.

Does this Gmail cleanup delete any emails?▼

No, the skill never deletes mail. It only applies labels and archives messages, so everything remains recoverable in All Mail. Archiving is the only destructive-adjacent action, and it requires batch approval unless --auto-approve is set.

Can I label Gmail messages without archiving them?▼

Yes, use the --labels-only flag to apply category labels while leaving messages in the inbox. You can also use --skip-newsletters to leave newsletter mail untouched during the pass.

What is required to run Gmail inbox cleanup with this skill?▼

It requires the Google Workspace MCP server connected to your Gmail account, with access to the mcp__google-workspace tools. The skill runs as a forked email-assistant agent using the gmail-processor and gmail-organizer procedures.