About email-cleanup
A Gmail cleanup skill for batch handling older promotional, social, and update emails, as well as reviewing large messages and unsubscribe candidates. It emphasizes counts before action, confirmation before deletion, and archiving in batches of up to 50.
Key features
- 01Finds emails by category and age
- 02Counts messages before cleanup
- 03Prefers archiving over deletion
- 04Processes batches of up to 50
- 05Flags large and unsubscribe-candidate emails for review
Use cases
- 01Archiving older promotional or social email
- 02Reviewing large messages to free storage
- 03Checking read updates and unsubscribe candidates
Install
Copy the command and run it in a terminal.
$
npx skills add https:/After installing, type/email-cleanupin Claude Code to confirm it loaded.
Details
From the project READMEABOUTME: Gmail bulk cleanup - archive old emails, delete promotions, free storage
ABOUTME: Parameterized batch operations with safety-first approach
Email Cleanup Skill
Gmail: See ../_GMAIL.md for account config and commands.
Safety Rules
- NEVER delete without confirmation - show counts first
- Archive over delete - prefer archiving (recoverable)
- Batch in chunks - max 50 at a time
Cleanup Targets
| Category | Query | Action |
|---|---|---|
| Promotions | category:promotions older_than:30d | Archive |
| Social | category:social older_than:14d | Archive |
| Read updates | category:updates is:read older_than:7d | Archive |
| Large emails | larger:10M | Review individually |
| Unsubscribe candidates | unsubscribe is:read older_than:30d | Review |
Workflow
Step 1: Count each category
gog gmail search "<query>" [email protected] --json | jq '.resultSizeEstimate'
Step 2: Present summary table with counts and suggested actions
Step 3: Execute (with confirmation)
THREADS=$(gog gmail search "<query>" [email protected] --json --max=50 | jq -r '.threads[].id')
for tid in $THREADS; do
gog gmail thread modify $tid [email protected] --remove-labels=INBOX
done
Process in batches of 50. Report progress.
Quick Stats
gog gmail labels get INBOX [email protected]
gog gmail labels get CATEGORY_PROMOTIONS [email protected]
Comments
Markdown supported