InboxSweeper
github.com
- Free plan
- Open source
- Windows
- macOS
- Linux
- Web
- Self-hosted
What InboxSweeper is
InboxSweeper is a free tool for clearing old promotional email and newsletters, with options to unsubscribe, move selected messages to Trash, or report senders as spam. Gmail is its primary fully supported provider; Yahoo and other IMAP inboxes are experimental. Three modes set different age ranges and sender caps: Sloth covers mail older than two years with up to 25 senders per run, Normal covers mail older than one year with up to 50, and MadMax includes recent promotional mail with up to 100. Before moving messages, it previews counts and protects financial, security, payment, receipt, and government mail. Messages moved to Trash are described as recoverable for about 30 days. One-click and mailto unsubscribe methods are supported, while web-link-only options are flagged for manual handling. InboxSweeper runs on the user's computer and says mail, credentials, and tokens are not uploaded. It offers a local browser interface, terminal CLI, AI-agent instructions, and a one-file Windows executable. The project recommends the browser app for people who do not want technical setup; terminal use is available for coders.
Who it suits
InboxSweeper suits people who want to clear promotional email, with a browser option for users who prefer not to handle technical setup and a CLI for coders. Windows users can also choose its one-file executable.
Good to know, and what to watch
- Free and open source, with no account or subscription.
- Previews counts before moving messages.
- Protects financial, security, payment, receipt, and government mail.
- Keeps mail and credentials on the user's computer.
- Provides browser, CLI, AI-agent, and Windows executable options.
- Gmail is the only fully supported provider.
- 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.
Plans
Every plan and priceFree
Free plan
The verdict
InboxSweeper offers several ways to review and clear promotional mail, with safeguards before messages are moved. Check provider support and the Yahoo folder limit before choosing it.
What the maker publishes
- API and SDKs
- The project documents IMAP connectivity and a local browser UI but does not publish a separate web API or SDK. source
- Authentication
- The product uses a scoped Gmail or Yahoo app password over IMAP rather than OAuth or Google Sign-In. source
- Build verification
- The Windows executable and releases provide GitHub and PyPI provenance attestations that can be checked with GitHub CLI or PyPI metadata. source
- Cleaning actions
- It can unsubscribe, move selected mail to Trash, or report selected senders as spam. source
- 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. source
- 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. source
- Credentials
- It uses a scoped app password rather than Google OAuth, with credentials stored in macOS Keychain or a locked file. source
- Credential storage
- Credentials are stored in macOS Keychain or protected local files and can also be supplied through environment variables. source
- 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. source
- Email providers
- Gmail is fully supported; Yahoo and other IMAP inboxes are experimental. source
- Feature: cleaning modes
- Sloth targets mail older than two years, Normal targets mail older than one year, and MadMax includes recent promotional mail. source
- Feature: dry run
- Sweeps preview message counts and support dry-run operation before confirmation. source
- Feature: protected mail
- Financial, security, payment, receipt, transactional, and government senders are automatically protected from sweeps. source
- 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. source
- Feature: sender profiling
- The profile command ranks bulk senders so users can identify the noisiest sources before acting. source
- Feature: spam reporting
- Reporting spam is a separate deliberate workflow that starts with no senders selected and requires confirmation. source
- Feature: unsubscribe
- The tool handles RFC 8058 one-click unsubscribe and mailto unsubscribe through message headers. source
- Gmail support
- Gmail is the fully supported provider and the tool uses Gmail server-side search through the X-GM-RAW extension. source
- Integrations
- The repository provides instructions for Claude Code, Codex, Jules, Cursor, and Gemini CLI. source
- Integrations
- Documented integrations include Gmail, Yahoo, generic IMAP providers, Claude Code, Codex, Jules, Cursor, and Gemini CLI workflows. source
- 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. source
- Licence
- The repository is licensed under the MIT License. source
- Limit: unsigned downloads
- The Windows executable and macOS launcher are unsigned, so browsers and operating systems may show download or unidentified-developer warnings. source
- Limit: unsubscribe coverage
- Web-link-only unsubscribe options are reported for manual handling and are never automatically clicked. source
Checked against the maker's pages on 15 Oct 2026.