Providers

One interface, every mailbox

Three adapters cover the entire market: the Gmail API, Microsoft Graph, and IMAP for everything else. Each maps its own folders onto the same set of roles, so a rule you write once behaves the same everywhere.

Gmail & Workspace

OAuth

The strongest backend. Full-text body search runs on Google's servers, category folders map directly, and deletions go 1,000 messages per call.

  • Click ConnectSign in with Google and approve the permission screen.
  • Grant the whole requestUnticking the Gmail permission connects the account but every clean then fails.

Moves mail to Trash, recoverable for 30 days in Gmail. No password is ever shared with us.

Outlook & Microsoft 365

OAuth

Covers outlook.com, hotmail.com, live.com and work accounts. Junk Email and Deleted Items map to the spam and trash roles.

  • Click ConnectSign in with the Microsoft account you want cleaned.
  • Accept consentWork accounts may need a one-time administrator approval.

Outlook has no Promotions or Social categories, so those roles resolve to nothing — the preview says so rather than widening the search.

Everything else

IMAP

Yahoo, iCloud, Mail.com, GMX, Zoho, Fastmail, AOL, Yandex and any other IMAP host. Server settings are discovered from your address.

  • Generate an app passwordMost providers no longer accept your account password over IMAP.
  • Enter your addressHost and port are filled in automatically.
  • Test and connectThe credential is verified live before it is saved.

Setup notes by provider

The handful of providers with a step that catches people out.

Yahoo Mail

Yahoo stopped accepting account passwords over IMAP in 2024. Go to Yahoo Account Security → Generate app password, create one named "Email Cleaner", and paste the 16-character value.

Yahoo files junk under "Bulk Mail", which maps to the spam role automatically.

Mail.com & GMX

IMAP is switched off by default. Open Settings → POP3 & IMAP, tick "Enable access to this account via POP3 and IMAP", and save. Then connect with your normal password.

Skipping this step produces an authentication failure with no useful explanation from the server.

iCloud

An app-specific password is mandatory and two-factor authentication must already be on. Generate one at appleid.apple.com → Sign-In and Security → App-Specific Passwords.

Covers icloud.com, me.com and mac.com.

AOL, Zoho, Fastmail, Yandex

Create an app password in the provider's security settings whenever two-factor authentication is enabled. Fastmail: Settings → Privacy & Security → App Passwords.

Providers that have not disabled basic authentication still accept a normal password.

Anything not listed

Type your address and connect. Settings come from a built-in table, then the Thunderbird autoconfig database covering thousands of domains, then a conventional guess — and the connection is always tested before saving.

If discovery gets it wrong, enter host, port and username manually.

Proton Mail

Proton has no public IMAP endpoint. It works only through Proton Mail Bridge running on the same machine as the service, which rules it out for our hosted version.

Self-hosting Email Cleaner alongside Bridge does work.

What differs between providers

The app compiles your rule to whatever each provider speaks, and tells you in the preview which filters ran on the server and which ran locally.

CapabilityGmailMicrosoftIMAP
Full body keyword searchServer-sideServer-sideServer-side
Category folders (Promotions, Social…)YesNot availableNot available
Date precisionExactExact (re-checked)Day, re-checked locally
Size filterYesNot exposedYes
Attachment filterYesYesChecked locally
Results per keyword searchUnlimited1,000, auto-split by dateUnlimited
Bulk delete batch size1,00020200
Undo from TrashYesYesBest effort

Anything a provider cannot do server-side is re-checked locally before deletion — a weaker backend is slower, never less safe.

Connect your first mailbox

The free plan covers one mailbox with no card required, and IMAP works immediately.