What problem does it solve? Cleaning up a cluttered Gmail inbox with thousands of old unread emails is tedious and risky when done manually. This Skill automates the process using IMAP and Gmail App Passwords, flagging deletion candidates while protecting important senders, so nothing valuable is lost. ## Core Features & Use Cases - Automated Inbox Scanning: Connects to Gmail via IMAP, searches for unread emails older than 30 days, and batch-fetches headers in groups of 50 for fast processing. - Sender Protection Rules: Filters emails through an is_protected() function that safeguards payroll, government, banking, and personal contacts from deletion. - Approval-Based Deletion: Flags candidates with a star, waits for user approval, then moves flagged emails to Gmail Trash using X-GM-LABELS. - Scheduled Cleanup: Runs daily via Hermes cron jobs as a no-agent Python script. - Use Case: A user with 3,600+ old unread emails schedules a daily 8am scan; the script flags 34 safe candidates, and after the user replies "approve delete", they are moved to trash automatically. ## Quick Start Set up a Gmail App Password, then ask the agent to scan my inbox for unread emails older than 30 days and flag the safe ones for deletion.
