Gmail Cleanup: Delete Old Promotions, Spam & Newsletters

    1

    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

    Security scanned

    Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIMuseMuseDotsDots+21 more

    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:

    1. Dry run first. Every session starts with a report only: category, sender, count and sample subjects per year, plus a separate borderline list.
    2. 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.
    3. Reversible actions only. It trashes (recoverable in Gmail for about 30 days) or marks spam. It never permanently deletes and never empties Trash.
    4. Keepers get organized. Remaining mail from each year is labeled Archive/YYYY.
    5. 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.

    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. 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. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

    3. 3

      Ask for what you need

      Your agent loads this skill and uses it on your task. It always asks before any payment.

    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 forever

    No account required to browse

    Trust & safety

    Security scan

    Security scan passed 9 days ago

    • Free with an Agensi account

    Requires

    Gmail

    Permissions

    File Scopes

    gmail-cleanup-log.md
    (undo
    log
    written
    to
    the
    working
    folder)
    learned.md
    (remembered
    senders
    created
    from
    learned.example.md
    in
    skill's

    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.

    Listed9 days ago
    Updated1 day ago

    What's inside

    Frequently Asked Questions

    No. It only moves threads to Trash (recoverable in Gmail for about 30 days) or marks them as spam. It never empties Trash or permanently deletes anything.

    No. It only scans mail older than 2 years. Recent mail is not scanned, reported, trashed or labeled.

    Yes. Financial senders, identity and account records, loan and statement threads, and anything with an attachment are excluded, including promotional mail from those senders. It also builds a protected-senders list that you confirm before anything happens.

    Yes. Every trashed thread is logged to gmail-cleanup-log.md. You can restore it from Gmail Trash or ask Claude to untrash it from the log.

    To confirm a thread is not personal or important, it may open and read threads through your Gmail connector. It does not copy, quote, summarize or send message contents anywhere, and it never opens links in emails.

    Two small files in your working folder: gmail-cleanup-log.md (undo log) and learned.md (senders you approved, kept or declined). It never stores subjects, message contents or identity data. You can edit or delete both at any time.

    No. It never opens unsubscribe links, because they can be phishing. It moves unwanted mail to Trash or Spam instead.

    New in Productivity