I built a one-click Gmail cleaner to bulk delete promos/newsletters and free up storage

I kept hitting Gmail and Google account storage warnings, but the manual cleanup flow is brutal. Search promotions, select all, delete, repeat. Same for social, newsletters, updates/forums, and then the real storage hogs: old emails with huge attachments.

So I built Gmail One-Click Cleaner, a Chrome extension that automates that exact workflow. It runs a conservative set of Gmail queries for old bulk mail, opens each search in your existing Gmail tab, selects all matching conversations (including “select all conversations that match this search” when Gmail shows it), deletes to Trash, and repeats passes until that filter is cleared. A progress tab shows what query is running and logs each step so it stays transparent.

The big thing I cared about is trust. It runs only on mail.google.com, logic runs locally in the browser, and nothing gets sent to external servers. Everything goes to Trash first so users can recover if they want.

It’s open source, and I’m trying to make the defaults safe for normal users but still aggressive enough to actually free storage. If you’ve built productivity extensions or you’re deep into Gmail power-user workflows, I’d love feedback on the default rules and what you’d want next (custom rules UI, review mode, better attachment targeting, stats on how much storage you freed).

Links

GitHub: https://github.com/TiltedLunar123/gmail-one-click-cleaner