- Home
- Skills
- Productivity
- Gmail Cleanup: Delete Old Promotions, Spam & Newsletters
Gmail Cleanup: Delete Old Promotions, Spam & Newsletters
Free Claude skill to clean up Gmail: finds old spam, promotions and newsletters, shows a dry-run plan, trashes only what you approve, labels the rest.
Free
Works with the AI Agents you already use
Gmail Cleanup: Delete Old Promotions, Spam & Newsletters
Example session with this skill installed
Clean up my Gmail. Find repeat advertisers and spam older than 2 years and show me a plan first.
- Read your context and instructions
- Compiled the gmail cleanup
Connects securely to your tools. The creator never sees your data.
About this skill
Gmail Cleanup is a free Claude skill that cleans up an old Gmail inbox: it deletes old promotional emails, spam and newsletters safely, and frees up mailbox space without risking the mail that matters. Gmail Cleanup scans mail older than 2 years, one year at a time, ranks the senders who keep advertising to you, and shows a plan before it changes anything.
How it works:
- Dry run first. Every session starts with a report only: category, sender, count and sample subjects per year, plus a separate borderline list.
- You approve. Nothing is trashed, marked as spam or labeled until you approve a specific list. A 10-thread spot check runs before the first trash.
- Reversible actions only. It trashes (recoverable in Gmail for about 30 days) or marks spam. It never permanently deletes and never empties Trash.
- Keepers get organized. Remaining mail from each year is labeled Archive/YYYY.
- Undo log. Every trashed thread is written to gmail-cleanup-log.md so you can restore it from Trash or ask Claude to untrash it.
Built to be cautious (default deny): it only acts when a thread is positively identified as bulk junk by at least two independent signals and fails every exclusion. It never touches:
- The last 2 years of mail
- Mail you sent, mail addressed to you as a person, starred or Important mail, or your own labels
- Identity and account records (KYC, government IDs, tax, insurance, credit reports, OTPs, security alerts, legal, medical, employment)
- Financial mail from banks, cards, lenders, insurers, brokers and payment apps, including their promos
- Anything with an attachment, and loan or statement threads
Lookalike senders (a known brand name on an unrelated domain) are reported as suspicious, never bulk-acted on. Text inside an email is treated as data and can never unlock an action. Batches are capped at 200 threads per approval. When it is unsure, it keeps the mail.
It learns from your choices: it remembers approved, kept and declined senders (senders only, never subjects or contents) in a local learned.md file and suggests them first next time. You still approve every round.
Privacy and access: it works through your Gmail connector. To confirm a thread is not personal or important, it may open and read threads, but it does not copy, quote, summarize or send message contents anywhere. It never opens unsubscribe links. The only files it writes are gmail-cleanup-log.md (undo log) and learned.md (remembered senders) in your working folder.
Tip: read the dry-run report before approving. Gmail Trash and Spam keep mail for about 30 days, so mistakes can be restored during that time.
Find more skills like this on the Claude Skills Marketplace, the Codex Skills Marketplace and the Gemini Skills Marketplace, or browse Claude Skills for Productivity.
Gmail only. Scans only mail older than 2 years; recent mail is never touched or reported. Trashes or marks spam, never permanently deletes, and does not unsubscribe or open links. It deliberately skips financial, identity, loan, attachment and personal mail, so some old promotions from banks, brokers and similar senders will stay. Needs your approval each round (maximum 200 threads per round). Because it prefers to keep anything uncertain, some junk will show up as borderline.</known_limitations>
<parameter name="sample_input">Clean up my Gmail. Find repeat advertisers and spam older than 2 years and show me a plan first.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before buying a skill.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
Fresh listing
Recently published to Agensi
Free to use
No account required to browse
Trust & safety
Security scan
Security scan passed 9 days ago
- Free with an Agensi account
- Accounts
Gmail
The Gmail connection must offer search_threads, get_thread, list_labels, create_label, label_thread, trash_thread and mark_thread_spam. Logs go to a working folder.
Permissions
File Scopes
Works through the user's Gmail connector; the skill itself makes no direct network calls. It may read thread content only to verify a candidate is not personal or important, and does not copy, quote or send it anywhere. It only trashes or marks spam after a dry-run report and explicit approval, and never permanently deletes.