InboxSweeper
InboxSweeper is a free tool for clearing old promotional messages and newsletters, with options to unsubscribe from mailing lists.
What InboxSweeper is
InboxSweeper is a free tool for clearing old promotional messages and newsletters, with options to unsubscribe from mailing lists. Gmail is fully supported; Yahoo and other IMAP inboxes are experimental. It can unsubscribe, move selected mail to Trash, or report senders as spam. Three modes target different age ranges and sender caps: Sloth covers mail older than two years with 25 senders per run, Normal covers mail older than one year with 50, and MadMax includes recent promotional mail with 100. Before moving messages, sweeps preview counts; financial, security, payment, receipt, and government mail is protected. Messages sent to Trash are described as recoverable for about 30 days. The tool runs on the user's computer and says it does not upload mail, credentials, or tokens. It is available as a local browser interface, terminal CLI, AI-agent instructions, and a one-file Windows executable. One-click and mailto unsubscribe methods are supported, while web-link-only options are flagged for manual handling. Yahoo IMAP exposes only about the 10,000 most recent messages in each folder.
Good
- Previews message counts before moving anything.
- Protects financial, security, payment, receipt, and government mail.
- Moves selected messages to recoverable Trash.
- Runs locally without uploading mail, credentials, or tokens.
Watch out
- Yahoo and other IMAP inboxes are experimental.
- Yahoo IMAP exposes only about 10,000 recent messages per folder.
- Web-link-only unsubscribe options require manual handling.
- Automatic cleanup rules are not supported.
Who it suits
InboxSweeper suits people clearing older promotional email, especially Gmail users who want previewed sweeps and unsubscribe options. Its terminal path is available for coders, while the project recommends the web app for users who do not want technical setup.
Verdict
InboxSweeper offers local bulk cleanup with safeguards and multiple ways to use it. Gmail is its fully supported target; users of other IMAP inboxes should account for the experimental status and Yahoo's message visibility limit.
Plans and prices
From InboxSweeper's own pricing page, checked 15 Oct 2001.
| Plan | Price | What it gives you |
|---|---|---|
| Free | Free | Gmail fully supported · Yahoo/other IMAP experimental · Sloth 25 senders/run · Normal 50 senders/run · MadMax 100 senders/run · No subscription or account |
The facts
Each one read from InboxSweeper's own pages, with the date it was checked.
What it does
- API and SDKs
- The project documents IMAP connectivity and a local browser UI but does not publish a separate web API or SDK.checked 15 Oct 2001
- Authentication
- The product uses a scoped Gmail or Yahoo app password over IMAP rather than OAuth or Google Sign-In.checked 15 Oct 2001
- Build verification
- The Windows executable and releases provide GitHub and PyPI provenance attestations that can be checked with GitHub CLI or PyPI metadata.checked 15 Oct 2001
- Cleaning actions
- It can unsubscribe, move selected mail to Trash, or report selected senders as spam.checked 29 Sep 2001
- Cleaning modes
- Sloth targets mail older than two years with a 25-sender run cap, Normal targets mail older than one year with a 50-sender cap, and MadMax includes recent promotional mail with a 100-sender cap.checked 29 Sep 2001
- Credentials
- It uses a scoped app password rather than Google OAuth, with credentials stored in macOS Keychain or a locked file.checked 29 Sep 2001
- Credential storage
- Credentials are stored in macOS Keychain or protected local files and can also be supplied through environment variables.checked 15 Oct 2001
- Developer interface
- The documented developer interface is a Python command-line tool with wizard, setup, counts, profile, sweep, spam, unsub-list, unsub-run, serve, and uninstall commands.checked 15 Oct 2001
- Email providers
- Gmail is fully supported; Yahoo and other IMAP inboxes are experimental.checked 29 Sep 2001
- Feature: cleaning modes
- Sloth targets mail older than two years, Normal targets mail older than one year, and MadMax includes recent promotional mail.checked 15 Oct 2001
- Feature: dry run
- Sweeps preview message counts and support dry-run operation before confirmation.checked 15 Oct 2001
- Feature: protected mail
- Financial, security, payment, receipt, transactional, and government senders are automatically protected from sweeps.checked 15 Oct 2001
- Feature: recoverable deletion
- Delete operations move mail to the provider Trash/Bin folder, described as recoverable for about 30 days, instead of permanently deleting it.checked 15 Oct 2001
- Feature: sender profiling
- The profile command ranks bulk senders so users can identify the noisiest sources before acting.checked 15 Oct 2001
- Feature: spam reporting
- Reporting spam is a separate deliberate workflow that starts with no senders selected and requires confirmation.checked 15 Oct 2001
- Feature: unsubscribe
- The tool handles RFC 8058 one-click unsubscribe and mailto unsubscribe through message headers.checked 15 Oct 2001
- Gmail support
- Gmail is the fully supported provider and the tool uses Gmail server-side search through the X-GM-RAW extension.checked 15 Oct 2001
- Integrations
- Documented integrations include Gmail, Yahoo, generic IMAP providers, Claude Code, Codex, Jules, Cursor, and Gemini CLI workflows.checked 15 Oct 2001
- Intended users
- The project recommends the web app for anyone without technical setup, offers a Windows executable for zero-setup use, and provides a terminal path for coders.checked 29 Sep 2001
- Licence
- The repository is licensed under the MIT License.checked 15 Oct 2001
- Limit: unsigned downloads
- The Windows executable and macOS launcher are unsigned, so browsers and operating systems may show download or unidentified-developer warnings.checked 15 Oct 2001
- Limit: unsubscribe coverage
- Web-link-only unsubscribe options are reported for manual handling and are never automatically clicked.checked 15 Oct 2001
- Limit: Yahoo visibility
- Yahoo IMAP exposes only about the 10,000 most recent messages per folder, so older backlog may be unreachable.checked 15 Oct 2001
The company
- Company facts
- The project identifies Mukundan Govindaraj as its author; no legal company name, headquarters, founding year, employee count, or funding information is stated on the reviewed pages.checked 15 Oct 2001
The full review of InboxSweeper
InboxSweeper pairs bulk mail cleanup with unsubscribe controls and lets users choose how aggressively to sweep. Its strongest case is Gmail cleanup from a local browser interface, Windows executable, terminal, or AI-agent workflow. Yahoo and other IMAP users face more uncertainty, and Yahoo’s folder visibility limit can leave older mail untouched.
Overview
InboxSweeper can unsubscribe from mailing lists, move selected messages to Trash, or report selected senders as spam. Before a sweep, it previews counts and protects financial, security, payment, receipt, and government mail. Moving messages to Trash rather than deleting them outright gives users about 30 days to recover mistakes, though that window does not eliminate the need to review a sweep carefully.
Gmail is the primary, fully supported provider; Yahoo and other IMAP inboxes are experimental. Yahoo IMAP exposes only about the 10,000 most recent messages in each folder, so users with older mail may not be able to clean their entire backlog.
Key features
Cleanup modes
- Sloth targets mail older than two years and caps a run at 25 senders. It suits a cautious pass over older clutter.
- Normal targets mail older than one year, with a 50-sender cap. This is the middle ground for users who want a broader sweep without including recent promotions.
- MadMax includes recent promotional mail and allows up to 100 senders per run. Its wider reach is useful for a badly overloaded inbox, but the larger scope makes the preview especially important.
Unsubscribe and privacy controls
One-click and mailto unsubscribe methods are supported; senders that offer only a web-link unsubscribe option are identified for manual handling. The software runs on the user’s computer and says mail, credentials, and tokens are not uploaded. Anonymous usage counters can be disabled with INBOXSWEEPER_NO_TELEMETRY=1.
InboxSweeper uses a scoped app password rather than Google OAuth. Credentials are stored in macOS Keychain or a locked file, a practical local-storage approach that may not suit users who prefer OAuth sign-in.
Pricing
InboxSweeper’s Free plan costs free, is open source, and requires no account or subscription. There is no free trial because the software is free. The plan includes unsubscribe tools and support for Gmail, Yahoo, and other IMAP inboxes, but it does not include bulk delete and archive or automatic cleanup rules. Its run caps also limit each sweep to 25, 50, or 100 senders depending on the selected mode.
Platforms
InboxSweeper supports Linux, macOS, web, and Windows. It offers a local browser interface, a one-file Windows executable, a terminal CLI, and instructions for use with Claude Code, Codex, Jules, Cursor, and Gemini CLI. The project recommends the browser app for people who want to avoid technical setup, the Windows executable for zero-setup use on Windows, and the terminal path for coders. Users with an unlisted issue are directed to open a GitHub issue with their OS, browser, and the exact wording of the problem.
Who it's for
InboxSweeper fits Gmail users who want a free, locally run tool with preview counts, protected categories, and recoverable Trash moves. It also suits coders and users who want to integrate cleanup into an AI-agent workflow. It is a weaker fit for anyone who needs dependable cleanup across non-Gmail IMAP providers, particularly Yahoo users whose older messages may fall outside the 10,000-message-per-folder window.
Pros and cons
- Pros: Free and open source, with no account or subscription required.
- Pros: Preview counts, protected mail categories, and Trash recovery of about 30 days help reduce the risk of an overly broad sweep.
- Pros: Multiple modes and interfaces accommodate both cautious cleanup and broader backlog clearing, from a browser to a CLI.
- Cons: Yahoo and other IMAP support is experimental, and Yahoo’s message visibility limit can exclude older mail.
- Cons: Web-link-only unsubscribe options require manual follow-up, and the tool does not provide bulk delete/archive or automatic cleanup rules.
- Cons: The scoped app-password approach is not Google OAuth, which may be a drawback for users who want OAuth-based credential handling.
Alternatives
For a broader comparison, see Email Cleanup Software.
- Clean Email is a better fit for readers who want a service spanning Android, iOS, macOS, and web, and can accept a free account capped at 1,000 messages without its Screener, Sender and Mailing List Settings, or Auto Clean features.
- Gmail Bulk Unsubscribe & Cleanup Tool is another free, MIT-licensed option across Linux, macOS, self-hosted, web, and Windows; it also offers a 1-on-1 Setup Service for $8, paid once.
- Cleanfox suits readers looking for a free inbox-cleaning and newsletter-unsubscribe option on Android, iOS, or web.
- Paperweight is worth considering for desktop users who value MIT-licensed software they can inspect or build, with Linux, macOS, and Windows support.
- Unroll.Me is a free option for Android, iOS, and web, but it requires access to commercial emails and uses commercial-email data for measurement products.
- Leave Me Alone offers a free Casual Emailer plan with four email accounts, unlimited unsubscribes, Private Emails, Screener, and Spam Blocker for readers who want those tools.
- Trimbox is an alternative across Android, extension, iOS, and web, with its first 10 unsubscribes free.
- Smart Delete for Gmail offers a free plan with 500 deletions per month and three deletion rules for readers who want rule-based Gmail deletion.
Verdict
Choose InboxSweeper if you want free, local Gmail cleanup with reviewable sweeps, protected message categories, and several ways to work. Its main advantage is the combination of those safeguards with flexible cleanup modes and interfaces; its main reason to look elsewhere is the experimental status of non-Gmail IMAP support, especially Yahoo’s limited folder visibility.
Getting started
- Open the InboxSweeper GitHub website
- Choose the local browser interface, Windows executable, terminal CLI, or an AI-agent path
- Use a scoped app password for Gmail access
- Run a sweep and review its preview counts
- Select an unsubscribe, Trash, or spam action
Limits worth knowing
Sloth, Normal, and MadMax cap runs at 25, 50, and 100 senders respectively. Yahoo IMAP exposes only about the 10,000 most recent messages per folder, and web-link-only unsubscribes are not automated.
Questions
How much does InboxSweeper cost?
The Free plan is free. It is free and open source, with no account or subscription.
Which email providers work?
Gmail is fully supported. Yahoo and other IMAP inboxes are experimental.
Which platforms can run it?
It supports Linux, macOS, web, and Windows, with browser, CLI, executable, and AI-agent options.
Does it upload email or credentials?
The tool runs on your computer and says mail, credentials, and tokens are not uploaded.
How are Gmail credentials handled?
It uses a scoped app password rather than Google OAuth, storing credentials in macOS Keychain or a locked file.
Can deleted messages be recovered?
Sweeps move messages to Trash, where they are described as recoverable for about 30 days.
Alternatives to InboxSweeper
- 1

Clean Email
Free planAndroidiOSWebmacOS8.0From $2.50 a month - 2
Paperweight
Free planOpen sourceLinuxmacOSWindows7.8From $4.58 a month - 3
Gmail Unsubscriber
Free planOpen sourceAndroidiOSWeb7.7Free plan - 4
Cleanfox
Free planAndroidiOSWeb7.3Free plan - 5
Gmail Unsubscribe
Free planWebAPIExtension7.2From $2.99 a month - 6
Gmail Bulk Unsubscribe & Cleanup Tool
Free planWebLinuxmacOSSelf-hosted6.9$8, paid once
