IMAP Cleanup Tool

Connection

Profile

Provider Host Port Useri Timeout (s) Passwordi

Folders iPick the folders to scan. Gmail uses special names like `[Gmail]/All Mail`, `[Gmail]/Trash` (may be localized). Connect first to load the list.

Not connected - folders will appear here. Defaults to INBOX.

Add to scan just includes a folder in the list above (creates nothing). Create on server actually creates a new folder - a label on Gmail - on your mailbox (e.g. to use as a move destination).

⚠️ Every action - Run, List senders, Empty folder, Move - applies to the selected folders above. On a folder row, 🗑 deletes it on the server (system folders like Trash/Sent are protected and have no 🗑), while × only removes it from this list.

What to match

Target list Rule (query builder)

Senders / domains, one per line i One entry per line:
• spam@example.com - exact sender address
• *@newsletter.com - that domain exactly, never subdomains
• annoying.com - that domain, plus subdomains if “Include subdomains” is on
• mail.annoying.com - that specific subdomain
• lines starting with # are comments
In "full" mode, *@paypal.com = paypal.com without Include-subdomains. The point: with Include-subdomains on, *@paypal.com stays exact while bare domains (e.g. newsletter.com) also catch their subdomains - so you can mix per-entry. ("search" mode is always a substring match.)

Load from file one entry per line · reuse across runs

Rules match server-side (substring), so a domain also matches its subdomains and partials - and *@ is not special here. For an exact domain with no subdomains, use a Target list with *@domain.com and scan mode "full".

Counts how many emails match the current filter in the selected folders - makes no changes.

Options

✨ AI Cleanup iScores every sender with a heuristic spam score (List-Unsubscribe, unread ratio, send frequency, sender pattern, bulk), then - with a configured model - asks an LLM to judge the senders above your threshold. Generate report only analyzes; later, Run will also delete the confirmed ones. Selecting this disables the other actions and the match list (it looks at all senders).

Model iThe LLM that judges the flagged senders. Configure models in the LLM tab. The local heuristic report works even without a model. Spam-score threshold: 6.0 / 10 iOnly senders scoring at or above this are flagged (and later sent to the LLM / deleted on Run). Higher = stricter, fewer senders. Sample emails per flagged sender iHow many example subjects per flagged sender go into the report (and to the LLM). Default 5. Exclude addresses (one per line) iSenders to skip entirely. Your own mailbox address is pre-filled here on connect so self-sent mail is skipped - remove it if you want your own address included too. Add one address per line.

Advanced: scoring weights (calibrated)

List-Unsubscribe Unread ratio Precedence bulk Sender pattern Send frequency

Skip LLM (heuristic only) iGenerate report using only the local heuristic spam score - no LLM call, so it is free and much faster and nothing leaves your machine. The report just won't have per-sender AI verdicts. The chosen model is still used if you press Run (deleting needs the LLM).

iEvery report is auto-saved to disk with a timestamp. Pick one here and download it as CSV - older reports stay available even after new runs or a restart.

Scan mode i "search" (default) - fast server-side IMAP SEARCH. It is a substring match on the From header, so it already matches subdomains (a target annoying.com also catches x@mail.annoying.com).

"full" - downloads each header and matches the exact domain locally (stricter). Enable “Include subdomains” to also catch subdomains in this mode.

Disabled because you’re using a Rule: rule matching is always a fast server-side SEARCH (subdomains already included). Scan mode applies only to Target lists.

Include subdomains iAffects "full" mode only. It expands bare-form domains (e.g. annoying.com → also mail.annoying.com). The *@domain form is always exact and is never expanded. In "search" mode subdomains match anyway (substring). Gmail: move to Trash iOnly for Gmail. A plain delete in INBOX just removes a label; this applies the \\Trash label so the message is really trashed. Auto-enabled when the host is imap.gmail.com.

⚠️ This does not free space on its own: messages sit in Trash for ~30 days. To remove them now, afterwards select the [Gmail]/Trash folder in the list and run Empty folder (carefully!). Expunge (permanent) i⚠️ Permanently removes flagged messages. Without it, messages are only flagged \\Deleted (hidden but recoverable until expunged).

With “Gmail: move to Trash” this has no effect - messages just go to Trash. To delete for good, then select [Gmail]/Trash and use Empty folder.

Move matched to another folder iInstead of deleting, move the matched messages to the destination below. On Gmail this relabels them (removes the source label, adds the destination). Mutually exclusive with delete / Gmail-trash / expunge.

Pick an existing folder, or choose ➕ Create new… to make one (a label on Gmail). Tip: leave the Target list / Rule empty to move every message in the selected folders.

Empty folder (delete ALL) i⚠️ Deletes every message in the folders you ticked in the Folders section above, ignoring the target list / rule. It does not touch other folders - only the selected ones.

⚠️ Will delete all messages in the selected folders (the ones ticked under Folders), not just matches.

Dry-run (preview only) iReports what would happen and changes nothing. Keep it on for your first run. Batch size iMessages per IMAP request when fetching headers or deleting. Higher = fewer round-trips but heavier requests. Default 500. On Gmail, delete/trash is auto-capped at 200 (Gmail rejects larger STORE commands).

Cleanup action

Deletes / moves matching messages in the selected folders. With dry-run on, “Run” only previews.

List senders

Shows the senders in the selected folders ranked by how many emails each sent - use it to decide what to target.

Downloads the last “List senders” result to your browser’s download folder. Edit the file name if you like; with “ask where to save” enabled, your browser also lets you choose the folder.

Log

New scheduled job

The job connects with a saved profile; folders, match and options come from the Cleanup tab. It runs the CLI on a schedule - different jobs can use different profiles (different accounts).

Connection profile Only non-encrypted profiles appear here - a cron can't type a password to decrypt one. Name Frequency Date Time Interval (minutes) Weekday Day of month (1-28)

✨ AI Cleanup job iMake this a scheduled AI Cleanup instead of a filter job: it scores senders, asks the model, then deletes the confirmed ones. Needs a non-encrypted model and the [ai] extra installed where the job runs.

Model Threshold Sample Report only (save the report, delete nothing) iThe job builds the report and deletes nothing. The report is saved on disk and, if email notifications for jobs are enabled, sent as a CSV attachment. Skip LLM (heuristic only, no model) iBuild the report from the local heuristic only - no LLM call, no API cost. Requires Report only (heuristic alone can't decide what to delete).

Saved jobs

Runs via the system scheduler (Task Scheduler / cron) - even when this app is closed.

Add / edit a model

The model used by AI Cleanup. Local-first & BYOA (Bring Your Own API key): run a free local model (Ollama) so nothing leaves your machine, or bring your own key for any cloud model (OpenAI, OpenRouter, ...). Powered by litellm, so both use the same form. The key is stored in a local SQLite DB and can be encrypted, and is never committed. ⚠️ Remote models send only sender subjects + stats (never the message body) to that provider - for full privacy prefer a local model.

Name Type Model string iA litellm model id. Examples: gpt-4o-mini, openrouter/meta-llama/llama-3.1-8b-instruct, ollama/llama3. API base URL (optional) iCustom endpoint. For local Ollama usually http://localhost:11434. Leave empty for the provider default. API key iStored locally (SQLite), never committed. Not needed for local models. Tick "Encrypt" to protect it (encrypted = not usable in scheduling).

Encrypt the API key iEncrypts the key with a password (never stored). An encrypted model cannot run in scheduled jobs (no one to type the password).

Keep track of costs iLogs token usage and computes cost from the prices below (per million tokens). A per-model cost log is shown in the list.

Input $ / 1M tokens Output $ / 1M tokens

Configured models

No models yet.

Add / edit an SMTP profile

Outgoing mail server used to send notification emails. The password is stored locally (SQLite) and can be encrypted (an encrypted profile can't run in scheduled jobs). Supports any provider - Gmail, Amazon SES, Outlook, SendGrid, etc.

Name Provider Host Port Security From address Username iSMTP login. For Amazon SES use the SES SMTP credentials; for Gmail your full address + an App Password. Password

Encrypt the password iEncrypts the password with a passphrase (never stored). An encrypted profile cannot send from scheduled jobs (no one to type it).

○ at least 8 characters
○ a lowercase letter
○ an uppercase letter
○ a number
○ a special character
○ both passphrases match

This passphrase is never stored - you'll need it to use the profile (encrypted profiles can't run scheduled jobs).

Notifications

Get an email when a cleanup finishes. One profile is active. By default emails are sent for scheduled jobs; you can also enable them for interactive runs. For Gmail accounts the email reminds you to empty the Trash.

Active SMTP profile Send notifications to Notify for scheduled jobs Notify for interactive runs

Saved SMTP profiles

No profiles yet.

Spam addresses

Senders flagged by AI Cleanup (report or run) for the connected mailbox, with their heuristic spam score and the LLM verdict. Select rows to remove them from the list, or report the sender as spam so the server learns to send their future mail to spam. (IMAP has no per-sender rule, so this works by moving the sender's mail into the Junk/Spam folder - the standard "report spam" signal that trains the provider's filter. Deleting unwanted mail is a separate action: AI Cleanup.) Each connection has its own list.

Select all (this page)

	Sender	Score	Msgs	Unread	/week	Signals	LLM verdict
No spam addresses yet - run an AI Cleanup report first.

Connection

Folders iPick the folders to scan. Gmail uses special names like `[Gmail]/All Mail`, `[Gmail]/Trash` (may be localized). Connect first to load the list.

What to match

Options

Log

New scheduled job

Saved jobs

Add / edit a model

Configured models

Add / edit an SMTP profile

Notifications

Saved SMTP profiles

Spam addresses

Job log -

Cost log -

Save connection profile

Unlock profile

Confirm

Connection

Folders iPick the folders to scan. Gmail uses special names like [Gmail]/All Mail, [Gmail]/Trash (may be localized). Connect first to load the list.

What to match

Options

Log

New scheduled job

Saved jobs

Add / edit a model

Configured models

Add / edit an SMTP profile

Notifications

Saved SMTP profiles

Spam addresses

Job log -

Cost log -

Save connection profile

Unlock profile

Confirm

Folders iPick the folders to scan. Gmail uses special names like `[Gmail]/All Mail`, `[Gmail]/Trash` (may be localized). Connect first to load the list.