Open source · AGPL-3.0 · runs locally

Take control of your inbox, in bulk.

Delete or move IMAP emails by sender, domain, or nested rules - from a slick local web app or the command line. Preview before you touch a thing. Your password never leaves your machine.

$ pip install "imap-cleanup-tool[web]"

Everything you need to tidy up

Powerful matching, a safety-first workflow, and zero lock-in.

Match anything

By exact sender, whole domain, or nested AND/OR rules built visually. No syntax to memorize.

See before you delete

Count exactly how many emails match, and run a dry-run first. Deletion is opt-in, never a surprise.

Fast on huge folders

Server-side IMAP search for tens of thousands of messages, or strict local matching when you need it.

Gmail-aware

Moves matches to Trash the right way and understands [Gmail]/All Mail and localized folders.

Web UI + CLI

A friendly local web app and a scriptable command line. The core is standard-library only and dependency-free.

Schedule it

Install jobs into Windows Task Scheduler or cron - once, hourly, daily, weekly, monthly. They run even when the app is closed.

Connection profiles

Save multiple accounts, optionally encrypted. Pick one from a dropdown. Secrets are never stored in plain text.

Runs anywhere

Windows, macOS, Linux. Even on a headless server - drive the GUI from your laptop over an SSH tunnel.

Yours to keep

Free and open source (AGPL-3.0). Everything runs on your machine - no cloud, no tracking.

Up and running in minutes

You only need Python 3.10+. No build steps, no servers to babysit.

1

Install

Grab it from PyPI - the web extra pulls in the UI too.

pip install "imap-cleanup-tool[web]"
2

Launch

Start the local web app. It opens in your browser.

imap-cleanup-tool-web
3

Connect & clean

Pick folders, build a rule, preview, then run. That's it.

Read the docs ↗

Open source, and proud of it.

Inspect every line, fork it, or send a pull request. Licensed under the AGPL-3.0 so it stays free for everyone - forever.