gmail-processor

Triages Gmail inboxes using paginated metadata-only queries and batch label operations.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Processing a large Gmail inbox manually is slow and reading every email body wastes time and tokens. This Skill sweeps all unread mail via paginated metadata-only queries, classifies messages by sender, subject, and snippet, and proposes batch archive or trash actions so you reach inbox zero with a single approval. ## Core Features & Use Cases - Full unread sweep with pagination: Retrieves every unread message using paginated search, never silently truncating at the first page. - Metadata-only triage into 6 buckets: Classifies mail as Urgent, Important, FYI, Newsletter, Marketing/Spam, or Ambiguous without fetching bodies, fetching content only for the small important set. - Safety overrides and batch actions: VIP contacts, financial/legal keywords, and starred mail are never auto-trashed, and all archive/trash operations run as batch label modifications after one consolidated approval. - Old-read cleanup: Finds read inbox mail older than 7 days and proposes batch archiving. - Use Case: You return from vacation to 300 unread emails. Run the triage to get a single proposal listing 5 urgent messages with summaries, 12 important ones, and batch archive/trash counts for the rest. ## Quick Start Ask the assistant to triage my Gmail inbox and propose cleanup actions to reach inbox zero.

Frequently Asked Questions about gmail-processor

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

FAQPage Schema
How do I triage a large Gmail inbox automatically?▼

Run a paginated unread sweep that classifies each message by sender, subject, and snippet into buckets like Urgent, Important, FYI, Newsletter, and Marketing. Bodies are fetched only for urgent and important mail, and all archive or trash actions are proposed in one batch approval.

How to reach inbox zero in Gmail without reading every email?▼

Classify messages using metadata only, since sender, subject, and snippet are enough to decide the fate of most mail. Batch-archive notifications and newsletters, batch-trash marketing, and keep only urgent and important messages in the inbox.

Does Gmail triage require the Google Workspace MCP server?▼

Yes, the Skill relies on the Google Workspace MCP server for search_gmail_messages, get_gmail_messages_content_batch, and batch_modify_gmail_message_labels. Without that MCP connection it reports the error and suggests checking /mcp status.

Can automatic email cleanup delete important messages by mistake?▼

Safety overrides move any message out of delete or auto-archive buckets if the sender is a VIP contact, the subject contains financial or legal keywords like invoice or contract, or the message is starred or marked important. All destructive actions also require explicit user approval first.

Why does Gmail search only return the first page of unread mail?▼

Gmail's default page size is small, so a search without a page_token silently misses messages beyond the first page. The Skill loops with next_page_token until the sweep is exhausted and asks before proceeding when unread counts exceed 500.