Skip to content
SPECIFICTION
Get listed

GMClean

github.com

Free plan WebSelf-hosted
Visit github.com
Spec score 8.5 #8 of 31 in Email Cleanup Software

What it is

GMClean is a free, self-hosted web tool for scanning email headers, classifying messages, unsubscribing in bulk, deleting email, and exporting data. It works with Gmail, Outlook, and custom IMAP mailboxes, with up to 10 mailboxes connected at once. GMClean fetches headers such as sender, subject, and List-Unsubscribe details without downloading message bodies. It can scan INBOX, Spam, Promotions, Trash, and other IMAP folders. Inbox analysis includes a 0–100 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 runs 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 app data stays in browser IndexedDB and there is no cloud database or telemetry. Credentials are encrypted with AES-256-CBC before storage, and setup requires an ENCRYPTION_SECRET. The repository is MIT-licensed.

Spec sheet

Purpose
GMClean scans email headers, classifies messages, and supports mass unsubscribe, bulk deletion, and export.Read 11 Oct 2026 · github.com
Product
GMClean is a self-hosted tool for scanning inboxes, classifying email, unsubscribing in bulk, deleting messages, and exporting data.Read 4 Oct 2026 · github.com
Deployment
The README provides npm development, Docker, and Docker Compose setup instructions.Read 11 Oct 2026 · github.com
Privacy
The README says GMClean fetches email headers only and does not download email bodies.Read 11 Oct 2026 · github.com
License
The repository says GMClean is licensed under the MIT License.Read 11 Oct 2026 · github.com
Account limit
The README says users can connect up to 10 mailboxes simultaneously.Read 11 Oct 2026 · github.com
AI integration
Optional Gemini-powered classification is available for ambiguous cases.Read 11 Oct 2026 · github.com
Authentication
It supports app passwords and OAuth2 for Google and Microsoft.Read 11 Oct 2026 · github.com
Bulk delete limit
Bulk email deletion is batched at 500 messages per batch.Read 11 Oct 2026 · github.com
Classification
Email classification uses heuristic rules and can optionally use Gemini for ambiguous cases.Read 4 Oct 2026 · github.com
Credential security
The README says credentials are encrypted with AES-256-CBC before storage and requires an ENCRYPTION_SECRET.Read 11 Oct 2026 · github.com
Email providers
It supports Gmail, Outlook, and custom IMAP mailboxes.Read 11 Oct 2026 · github.com
Email providers and authentication
The README lists Gmail, Outlook, and custom IMAP support, with app passwords or OAuth2 for Google and Microsoft.Read 4 Oct 2026 · github.com
Exports
It can export selected subscriptions and scanned emails to CSV.Read 11 Oct 2026 · github.com
Folder scanning
It can scan INBOX, Spam, Promotions, Trash, and other IMAP folders.Read 11 Oct 2026 · github.com
Header-only scanning
GMClean says it fetches email headers such as subject, sender, and List-Unsubscribe, and does not download email bodies.Read 4 Oct 2026 · github.com
Inbox analysis
It provides a 0–100 inbox health score based on five weighted factors, plus sender insights and email age distribution.Read 4 Oct 2026 · github.com
Inbox insights
It provides a 0–100 inbox health score, sender insights, email age distribution, and inbox analytics.Read 11 Oct 2026 · github.com
License and support
The repository is MIT-licensed and invites contributions through GitHub pull requests.Read 4 Oct 2026 · github.com
Local data
The README says app data is stored in browser IndexedDB and the app has no cloud database or telemetry.Read 11 Oct 2026 · github.com
Local storage
GMClean says data is stored in browser IndexedDB and that it has no cloud database, telemetry, tracking cookies, or analytics scripts.Read 4 Oct 2026 · github.com
Mailboxes
It supports up to 10 Gmail, Outlook, or custom IMAP mailboxes at once.Read 4 Oct 2026 · github.com
Maker location
The GitHub profile for Hussein Khalid lists Estonia.Read 4 Oct 2026 · github.com
Unsubscribe
It supports one-click unsubscribe with RFC 8058 List-Unsubscribe-Post support and bulk unsubscribe.Read 11 Oct 2026 · github.com
Unsubscribe and delete
It supports one-click RFC 8058 unsubscribe and bulk unsubscribe, while bulk email deletion is batched at 500 messages per batch.Read 4 Oct 2026 · github.com

Plans and prices

Open source Free MIT licensed · self-hosted Read 11 Oct 2026 · github.com

Every GMClean plan and price →

Strong points and limits

Strong points

  • Scans headers without downloading email bodies.
  • Supports up to 10 mailboxes at once.
  • Offers bulk unsubscribe and CSV exports.
  • MIT-licensed and self-hosted.

Limits

  • Bulk deletion is limited to batches of 500 messages.
  • Classification uses heuristic rules; Gemini is optional.
  • Setup requires an ENCRYPTION_SECRET.
  • App data is stored in browser IndexedDB.

Who it suits

GMClean suits people who want to review and clean multiple Gmail, Outlook, or IMAP inboxes using a self-hosted tool. Its header-only approach may appeal to users who do not want message bodies downloaded.

Verdict

GMClean combines inbox analysis with unsubscribe, deletion, and export tools while keeping its stated processing to email headers. Its self-hosted setup and batch limits are important to weigh before connecting mailboxes.

Where Specifiction places it

Alternatives to GMCleanAll alternatives →