GMClean
github.com
- Free plan
- Web
- Self-hosted
What GMClean is
GMClean is a self-hosted web tool for analyzing and cleaning email inboxes. It scans headers such as subject, sender, and List-Unsubscribe details without downloading message bodies, and it can connect up to 10 Gmail, Outlook, or custom IMAP mailboxes at once. It can scan INBOX, Spam, Promotions, Trash, and other IMAP folders. Its analysis includes a 0–100 inbox health score based on five weighted factors, sender insights, and email age distribution. Classification uses heuristic rules, with optional Gemini assistance for ambiguous cases. Users can unsubscribe with one click using RFC 8058 support or unsubscribe in bulk; bulk deletion is processed in batches of 500 messages. Exports include selected subscriptions with resubscribe links and scanned emails in CSV format. The project documents deployment with npm, Docker, or Docker Compose. It says data is kept in browser IndexedDB, with no cloud database or telemetry. Credentials are encrypted with AES-256-CBC before storage, and setup requires an ENCRYPTION_SECRET described as an AES-256 key. The repository is MIT-licensed and invites contributions through GitHub pull requests.
Who it suits
GMClean suits people who want to manage multiple Gmail, Outlook, or IMAP inboxes through a self-hosted web tool. Its deployment options and MIT license may also suit developers who want to run or contribute to the project.
Good to know, and what to watch
- Scans headers without downloading message bodies
- Connects up to 10 supported mailboxes
- Offers one-click and bulk unsubscribe
- Exports email and subscription data to CSV
- Bulk deletion runs in batches of 500 messages
- Requires an ENCRYPTION_SECRET for credential storage
Plans
Every plan and priceOpen source
Open source
Getting started
- Open the GMClean project on GitHub
- Deploy it with npm, Docker, or Docker Compose
- Set the required ENCRYPTION_SECRET as an AES-256 key
- Connect Gmail, Outlook, or custom IMAP mailboxes
- Authenticate with an app password or Google/Microsoft OAuth2
- Open the web interface and scan selected IMAP folders
Limits to check
Bulk deletion runs in batches of 500 messages. The tool supports a maximum of 10 connected mailboxes.
The Club's review
GMClean is a self-hosted browser tool for cleaning and analysing Gmail, Outlook, and custom IMAP accounts. It suits technically confident individuals or teams that want to run their own email-maintenance service across multiple mailboxes. The trade-off is that deployment, credentials, and encryption-secret management remain your responsibility.
Overview
GMClean combines inbox analysis with bulk unsubscribe, deletion, and export workflows. Its support for up to 10 simultaneous mailboxes makes it more suitable for administrators or households managing several accounts than for a single-inbox, set-and-forget service. Running it with npm, Docker, or Docker Compose offers deployment choice, while the MIT licence permits modification and contribution through GitHub.
Key features
The scanner works from headers such as sender, subject, and List-Unsubscribe rather than downloading message bodies. That reduces the email content GMClean handles while retaining enough metadata for sender insights, email-age distribution, and a 0–100 inbox health score calculated from five weighted factors. Classification uses heuristic rules, with optional Gemini processing for ambiguous cases; users who prefer a non-AI default can leave that option unused.
Scanning covers INBOX, Spam, Promotions, Trash, and other IMAP folders, so cleanup is not limited to the primary inbox view. GMClean can connect Gmail, Outlook, or custom IMAP mailboxes, using app passwords or OAuth2 for Google and Microsoft accounts. Up to 10 mailboxes can be connected at once, a meaningful capacity for small operational setups.
One-click RFC 8058 unsubscribe, including List-Unsubscribe-Post support, and bulk unsubscribe target mailing-list clutter directly. Deletion is more controlled: bulk email actions run in batches of 500 messages, so a large purge proceeds in repeated batches rather than one unlimited operation. You can export selected subscriptions with resubscribe links or export all scanned emails as CSV, useful when keeping an external record or reversing subscription decisions.
App data is stored in browser IndexedDB, and GMClean says it has no cloud database, telemetry, tracking cookies, or analytics scripts. Credentials are encrypted with AES-256-CBC before storage, with an ENCRYPTION_SECRET required as the AES-256 key. Those protections benefit privacy-conscious operators, but the security of the deployment and secret handling still depends on the person running it.
Pricing
| Plan | Price | What it includes |
|---|---|---|
| Open source | Free | MIT-licensed, self-hosted GMClean with its mailbox, scanning, unsubscribe, deletion, classification, and export features. |
There is no paid hosted tier in this plan structure. The free open-source model is a strong fit for readers able to provide their own hosting and operational oversight; readers who want vendor-managed infrastructure, support, or a simpler consumer setup should consider a hosted alternative instead.
Platforms
GMClean is delivered as a self-hosted web application. The project documents npm, Docker, and Docker Compose deployment, and connects Gmail, Outlook, and custom IMAP servers through app passwords or Google and Microsoft OAuth2.
Who it's for
Choose GMClean if you manage several compatible mailboxes, want header-based processing, and are comfortable deploying software and protecting an encryption secret. It is particularly relevant to privacy-minded operators who prefer browser-local data and no stated telemetry. It is a weaker fit for people who want a ready-made mobile app, a managed cloud account, or a support-led onboarding process.
Pros and cons
Pros
- Header-only processing: subjects, senders, and unsubscribe headers support analysis without downloading message bodies.
- Multi-mailbox coverage: up to 10 Gmail, Outlook, or custom IMAP accounts can be handled simultaneously.
- Actionable cleanup: RFC 8058 one-click and bulk unsubscribe sit alongside deletion and CSV export.
- Local data posture: browser IndexedDB storage, no cloud database, and no stated telemetry keep the architecture locally focused.
- Open-source deployment: MIT licensing and npm, Docker, and Docker Compose options allow inspection and adaptation.
Cons
- Self-hosting overhead: you must deploy the application and correctly configure ENCRYPTION_SECRET and account authentication.
- Deletion batching: bulk removal is limited to 500 messages per action, adding rounds to large cleanups.
- Heuristic classification: categorisation is rule-based by default, with Gemini only an optional aid for ambiguous cases.
- No managed plan: readers seeking hosted maintenance or a paid support tier will need another product.
Alternatives
Email Cleanup Software is the broader list to consult when comparing cleanup tools by platform and pricing.
Clean Email is the better choice for a hosted, multi-platform service with Android, iOS, macOS, and web clients, plus a free account that cleans up to 1,000 messages and paid features beyond that cap.
Cleanfox suits readers who want a free Android, iOS, or web tool focused on inbox cleaning and newsletter unsubscribe without self-hosting.
GoodByEmail is worth considering when unlimited inboxes, unsubscribes, inbox size, and email history on one device justify its paid Lite plan.
Unroll.Me is a free mobile-and-web option, but it requires access to commercial emails and uses commercial-email data for measurement products.
Gmail Unsubscriber is another open-source, MIT-licensed option for readers specifically seeking a Gmail-focused project.
Leave Me Alone fits users wanting a consumer-facing Android or web service with unsubscribe and screening tools.
Trimbox is a simpler freemium route across Android, iOS, web, and extension platforms, with the first 10 unsubscribes free.
ClearInbox is a self-hosted web alternative whose free account connects one mailbox.
Verdict
GMClean is a strong choice for technically capable users who need multi-mailbox cleanup while keeping scanning and app data close to their own infrastructure. Its main reason to choose it is the combination of header-only analysis, local browser storage, and open-source control. Look elsewhere if you want managed hosting, mobile apps, or a workflow that does not require you to operate the deployment and safeguard its encryption secret.
The verdict
GMClean combines inbox analysis, unsubscribe controls, deletion, and export in a self-hosted project. Its header-only scanning and local browser storage are central details for teams assessing how it handles email data.
Questions people ask
How much does GMClean cost?
GMClean is free and MIT licensed. It is distributed as open-source software for self-hosting.
Which email providers work with GMClean?
It supports Gmail, Outlook, and custom IMAP servers. Google and Microsoft connections can use app passwords or OAuth2.
Does GMClean download email bodies?
No. It fetches headers such as subject, sender, and List-Unsubscribe details.
Where is GMClean data stored?
Application data is stored in browser IndexedDB. The project says it has no cloud database, telemetry, tracking cookies, or analytics scripts.
What the maker publishes
- Account limit
- The README says users can connect up to 10 mailboxes simultaneously. source
- AI integration
- Optional Gemini-powered classification is available for ambiguous cases. source
- Authentication
- It supports app passwords and OAuth2 for Google and Microsoft. source
- Bulk delete limit
- Bulk email deletion is batched at 500 messages per batch. source
- Classification
- Email classification uses heuristic rules and can optionally use Gemini for ambiguous cases. source
- Credential security
- The README says credentials are encrypted with AES-256-CBC before storage and requires an ENCRYPTION_SECRET described as an AES-256 key. source
- Credential security
- The README says credentials are encrypted with AES-256-CBC before storage and requires an ENCRYPTION_SECRET. source
- Deployment
- The project documents running GMClean with npm, Docker, or Docker Compose. source
- Deployment
- The README provides npm development, Docker, and Docker Compose setup instructions. source
- Email providers
- It supports Gmail, Outlook, and custom IMAP mailboxes. source
- Email providers and authentication
- The README lists Gmail, Outlook, and custom IMAP support, with app passwords or OAuth2 for Google and Microsoft. source
- Exports
- It can export selected subscriptions with resubscribe links and all scanned emails to CSV. source
- Exports
- It can export selected subscriptions and scanned emails to CSV. source
- Folder scanning
- It can scan INBOX, Spam, Promotions, Trash, and other IMAP folders. source
- Folder scanning
- It can scan INBOX, Spam, Promotions, Trash, and other IMAP folders. source
- Header-only scanning
- GMClean says it fetches email headers such as subject, sender, and List-Unsubscribe, and does not download email bodies. source
- Inbox analysis
- It provides a 0–100 inbox health score based on five weighted factors, plus sender insights and email age distribution. source
- Inbox insights
- It provides a 0–100 inbox health score, sender insights, email age distribution, and inbox analytics. source
- License
- The repository says GMClean is licensed under the MIT License. source
- License and support
- The repository is MIT-licensed and invites contributions through GitHub pull requests. source
- Local data
- The README says app data is stored in browser IndexedDB and the app has no cloud database or telemetry. source
- Local storage
- GMClean says data is stored in browser IndexedDB and that it has no cloud database, telemetry, tracking cookies, or analytics scripts. source
- Mailboxes
- It supports up to 10 Gmail, Outlook, or custom IMAP mailboxes at once. source
- Maker location
- The GitHub profile for Hussein Khalid lists Estonia. source
Checked against the maker's pages on 11 Oct 2026.