Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

GMClean

github.com

  • Free plan
  • Web
  • Self-hosted
7.4 Club score Visit github.com

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

Open source

Free

Open source

Getting started

  1. Open the GMClean project on GitHub
  2. Deploy it with npm, Docker, or Docker Compose
  3. Set the required ENCRYPTION_SECRET as an AES-256 key
  4. Connect Gmail, Outlook, or custom IMAP mailboxes
  5. Authenticate with an app password or Google/Microsoft OAuth2
  6. 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

PlanPriceWhat it includes
Open sourceFreeMIT-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.