# Gururagavendra/gmail-cleaner

web based GUI to cleanup gmail delete, mark as read, unsubsribe from uncessary things u dont like

Repository: https://github.com/Gururagavendra/gmail-cleaner
Canonical: https://ross.abutalabs.com/products/gmail-cleaner
Homepage: https://gururagavendra.github.io/gmail-cleaner/
Language: Python
License: MIT
License Family: permissive
Topics: gmail, opensource, self-hosted, cleaning-data, cleanup-script, cleanup-tool
Last push: 2026-08-18T06:21:13+00:00

## Health v2 (maintenance only)
Score: 70/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 98, release rhythm 62, longevity 19
- inputs: {"age_days": 277, "days_push": 15, "days_rel": 253, "gap_med": 0, "n_releases_24m": 10}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2074, forks 133 (observed 2026-08-28T04:06:10.598933+00:00)

## What it is
A free, open-source, self-hosted web application for bulk cleaning of Gmail inboxes. It runs locally via Docker or Python and uses the Gmail API to unsubscribe from newsletters, delete emails by sender, and mark emails as read without any data leaving the user's machine.

## Use cases
- bulk unsubscribe from newsletters in gmail
- delete all emails from a specific sender
- mark thousands of unread emails as read
- clean up promotional clutter in my inbox
- archive emails from selected senders in bulk
- manage gmail labels for specific senders
- export email metadata to csv
- achieve inbox zero quickly

## When to choose
- you want a free, privacy-focused tool that runs entirely locally with no external servers
- you need bulk operations like unsubscribe, delete-by-sender, or mark-as-read across thousands of gmail messages
- you prefer a self-hosted, open-source alternative to paid inbox-cleaning services
- you want a simple web UI with smart filters by date, size, and category

## When to avoid
- you use a non-Gmail provider like Outlook or a generic IMAP server
- you are not comfortable creating your own Google OAuth credentials
- you need fully automated, scheduled background cleanup rather than interactive one-off operations
- you need enterprise-grade support or SLAs

## Facets
- artifact type: application
- maturity: active
- function: email, gui, developer-tools
- domain: email, developer-tools, privacy, self-hosted
- platform: windows, self-hosted, python
- tags: gmail, bulk-unsubscribe, inbox-cleanup, oauth, gmail-api, privacy-first, email-management, linux, macos, docker, web-server

## Member repositories
- Gururagavendra/gmail-cleaner (main) score 70

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:10.598933+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:56:20.274707+00:00, confidence not recorded.
  - readme: https://github.com/Gururagavendra/gmail-cleaner (fetched 2026-08-28T04:06:10.598933+00:00, sha 851aac3c232e)
  - homepage: https://gururagavendra.github.io/gmail-cleaner/ (fetched 2026-08-29T10:36:33.761694+00:00, sha 7f273b4552e8)
- Data as of 2026-08-30T08:39:29.467469+00:00.