Skip to content
SPECIFICTION
Get listed

Gmail Bulk Unsubscribe & Cleanup Tool

gururagavendra.github.io

Free plan Open source WebWindowsmacOSLinuxSelf-hosted
Visit gururagavendra.github.io
Spec score 9.3 #2 of 31 in Email Cleanup Software

What it is

Gmail Bulk Unsubscribe & Cleanup Tool helps Gmail users handle unwanted messages in batches. It supports automatic one-click and manual unsubscribe methods, and can delete messages from multiple senders, archive email, manage labels, and mark messages read or important. Filters cover date range, email size, category, sender, and labels; the tool can also download email metadata as CSV. It works through the Gmail API, so users must create their own Google Cloud project and OAuth credentials. The maker says it runs locally without external servers or data collection, keeping email on the user's machine. Its requested access is described as read and modify permissions, with users controlling their own OAuth app. Setup requires Docker or Python 3.9+ with uv, along with the user's Google credentials. The software is free under the MIT license. A one-on-one setup service is listed at $8, paid once. Deleted messages go to Gmail Trash and can be recovered there within 30 days.

Spec sheet

What it does
Gmail Cleaner bulk-unsubscribes newsletters, deletes mail by sender and marks messages as read while running locally.Read 15 Oct 2026 · gururagavendra.github.io
Purpose
The tool bulk unsubscribes from emails, deletes emails by sender, and marks emails as read.Read 2 Oct 2026 · gururagavendra.github.io
Platforms
Docker and Python installations are listed for Linux x86_64, Windows x86_64, macOS Intel, and Apple Silicon M1/M2/M3/M4.Read 2 Oct 2026 · github.com
Integrations
The documented external integration is the Gmail API.Read 15 Oct 2026 · github.com
Privacy
The maker says processing is local, emails do not leave the machine and no external servers or data collection are used.Read 15 Oct 2026 · gururagavendra.github.io
Support
The repository says the maker may be delayed in responding to issues and pull requests while taking personal time.Read 2 Oct 2026 · github.com
API and SDKs
Documentation explains using the Gmail API but does not present a separate public product API or SDK.Read 15 Oct 2026 · github.com
Archiving
Selected senders' messages can be archived to remove them from the inbox.Read 15 Oct 2026 · github.com
Batch performance
The project says Gmail API batch requests process 100 emails per API call.Read 15 Oct 2026 · github.com
Bulk unsubscribe
The tool finds newsletters and supports both automatic one-click and manual unsubscribe methods.Read 15 Oct 2026 · gururagavendra.github.io
Community traction
The GitHub repository page showed about 2.1k stars and 138 forks when opened.Read 15 Oct 2026 · github.com
CSV export
Email metadata for selected senders can be downloaded as CSV.Read 15 Oct 2026 · github.com
Delete by sender
Users can identify heavy senders and delete their messages in bulk.Read 15 Oct 2026 · github.com
Deletion limit
Deleted messages go to Gmail Trash and can be recovered there within 30 days.Read 2 Oct 2026 · github.com
Documentation and support
Setup instructions, FAQ, advanced configuration, troubleshooting, video guidance, GitHub issues and contribution instructions are provided.Read 15 Oct 2026 · github.com
Filters
Filters include date range, email size, category, sender, and labels.Read 2 Oct 2026 · github.com
Importance control
Users can mark or unmark messages from selected senders as important.Read 15 Oct 2026 · github.com
Independent description
An external Chinese-language tools site described the project as free, open source, local and deployable through Docker or Python.Read 15 Oct 2026 · ahhhhfs.com
Independent feature summary
The same external write-up highlighted unsubscribe, sender deletion, bulk read marking, filters, local privacy and Gmail API batching.Read 15 Oct 2026 · ahhhhfs.com
Independent platform summary
The external write-up listed Docker and Python deployment on Linux, Windows, Intel macOS and Apple Silicon macOS.Read 15 Oct 2026 · ahhhhfs.com
Integration
The tool uses the Gmail API and requires users to create their own Google Cloud project and OAuth credentials.Read 2 Oct 2026 · github.com
Intended user
The maker offers a paid one-on-one setup service for people who need help with Docker, Google Cloud Console, or credentials.json.Read 2 Oct 2026 · github.com
Interface
The repository describes a Gmail-style interface with real-time progress tracking.Read 15 Oct 2026 · github.com
Label management
The interface can create, delete, apply and remove Gmail labels for sender-selected mail.Read 15 Oct 2026 · github.com
Licence
The repository and product footer identify the licence as MIT.Read 15 Oct 2026 · github.com
Limit: bulk-delete bug
A Reddit user reported an “Error: undefined” failure when deleting multiple emails, while one-by-one deletion worked.Read 15 Oct 2026 · reddit.com
Limit: Gmail-only demand
Reddit users asked for Hotmail/Live and other-provider support, indicating the published tool is focused on Gmail.Read 15 Oct 2026 · reddit.com
Limit: missing automation
Reddit users requested scheduled deletion, broader provider support and an API for automation.Read 15 Oct 2026 · reddit.com
Limit: OAuth complexity
Reddit discussion included confusion and errors around remote-server OAuth, localhost use and credentials setup.Read 15 Oct 2026 · reddit.com
Limit: trust concerns
Some Reddit participants said they were uncomfortable granting Gmail access to a relatively unknown script and preferred manual cleanup.Read 15 Oct 2026 · reddit.com
Maker background
The maintainer's profile says he builds backend systems, developer tools and AI/LLM workflows and works with Python, React, Django and FastAPI.Read 15 Oct 2026 · github.com
Maker identity
The linked GitHub profile identifies the maintainer as Gururagavendra V, a software engineer at Fulfil and former Rapyuta Robotics employee.Read 15 Oct 2026 · github.com
More cleanup actions
It can bulk delete from multiple senders, archive emails, manage labels, mark messages important, and download email metadata as CSV.Read 2 Oct 2026 · github.com
Multi-sender deletion
The repository describes simultaneous deletion from multiple senders with progress tracking.Read 15 Oct 2026 · github.com
Notable news
The maintainer's November 29, 2025 Reddit launch post said the project later gained Docker, FastAPI/uv migration, batch processing and basic tests.Read 15 Oct 2026 · reddit.com
OAuth model
Each user must create and control their own Google Cloud OAuth application and credentials.Read 15 Oct 2026 · github.com
Operating systems
Docker and Python support are listed for x86_64 Linux, x86_64 Windows, Intel macOS and Apple Silicon macOS M1 through M4.Read 15 Oct 2026 · github.com
Permissions
The repository describes the requested access as read and modify permissions and says users control their own Google OAuth app.Read 2 Oct 2026 · github.com
Praise: installation
A Reddit user reported that Docker Compose installation worked perfectly for them.Read 15 Oct 2026 · reddit.com
Praise: local privacy
A Reddit commenter praised the approach of running locally with nothing sent elsewhere.Read 15 Oct 2026 · reddit.com
Praise: usefulness
Reddit commenters called the project useful, fantastic and a good fit for clearing large inboxes.Read 15 Oct 2026 · reddit.com
Read-status action
It can mark thousands of unread Gmail messages as read in bulk.Read 15 Oct 2026 · github.com
Release activity
The GitHub releases page lists versions through v1.3.0 and describes fixes for mark-as-read behavior, token handling and exception handling.Read 15 Oct 2026 · github.com
Security controls
The README says access uses read and modify permissions, users control their OAuth app and credentials files are gitignored.Read 15 Oct 2026 · github.com
Self-hosting
Docker Compose and local Python execution are both documented, with the web interface available on localhost port 8766.Read 15 Oct 2026 · github.com
Setup requirement
Users need Docker or Python 3.9+ with uv and must supply their own Google credentials.Read 2 Oct 2026 · github.com
Smart filters
Filters cover date range, message size, Gmail category, sender and labels.Read 15 Oct 2026 · github.com
System requirements
Local installation requires Python 3.9 or newer and uv; Docker users need Docker Desktop.Read 15 Oct 2026 · github.com
Unsubscribe
It supports automatic one-click and manual unsubscribe methods.Read 2 Oct 2026 · gururagavendra.github.io

Plans and prices

Free Free No subscription · free to use under MIT license Read 2 Oct 2026 · gururagavendra.github.io
Free Free free forever bulk unsubscribe · bulk deletion · archiving · local execution · MIT-licensed open source Read 15 Oct 2026 · github.com
1-on-1 Setup Service $8, paid once one-time setup session Google Meet guidance · Docker/Google Cloud/credentials help · under-20-minute target Read 15 Oct 2026 · github.com

Every Gmail Bulk Unsubscribe & Cleanup Tool plan and price →

Strong points and limits

Strong points

  • Supports automatic and manual unsubscribe
  • Filters by date, size, category, sender, and labels
  • Can archive, label, and mark messages
  • Runs locally, according to its maker
  • Deleted messages remain recoverable in Trash for 30 days

Limits

  • Requires users' own Google Cloud project and credentials
  • Setup requires Docker or Python 3.9+ with uv
  • Requested access includes read and modify permissions

Who it suits

It suits Gmail users who want batch cleanup and are comfortable setting up Google Cloud credentials and running Docker or Python. The listed setup service may suit users who want guided installation help.

Gmail Bulk Unsubscribe & Cleanup Tool in depth

Read the full write-up

Gmail Bulk Unsubscribe & Cleanup Tool is a locally run Gmail utility for unsubscribing and managing messages in bulk. It suits people willing to configure their own Google credentials and run Docker or Python; its range of cleanup actions is appealing, but setup is a meaningful hurdle.

Overview

This tool combines subscription cleanup with bulk message management: users can unsubscribe, delete, archive, mark messages read or important, and manage labels. Its Gmail focus keeps the job clear, while filters let users narrow actions by date range, size, category, sender, or label. The trade-off is a do-it-yourself installation and Google Cloud setup rather than a ready-to-connect inbox service.

Key features

Unsubscribing is available through automatic one-click and manual methods. For cleanup, users can delete messages from multiple senders or archive them, and can mark messages read or important. The filter set is practical for targeted work: date, size, category, sender, and label criteria help avoid applying a bulk action too broadly. Label management and CSV downloads of email metadata add utility for users who want to organize or retain a record of inbox information.

The tool uses the Gmail API and requests read and modify permissions. Its maker says it runs locally without external servers or data collection, with users controlling their own Google OAuth app. That model may suit users who prefer a local workflow, but the permission grant still deserves care, and creating a Google Cloud project and OAuth credentials is part of the setup. Deleted messages go to Gmail Trash and remain recoverable there within 30 days, so deletion is not immediate permanent removal.

Pricing

PlanPriceWhat it includesFreefreeUse under the MIT license with no subscription.1-on-1 Setup Service$8, paid oncePersonal setup guidance via Google Meet until installation works.The free plan is the product itself, not a capped trial: there is no subscription or stated usage quota. It is the natural choice for technically comfortable users who can install and configure it. The one-time setup service is for people who want help with Docker, Google Cloud Console, or credentials.json; it adds guidance, not a different cleanup plan. Users need Docker or Python 3.9+ with uv either way, and the maker warns that replies to issues and pull requests may be delayed.

Platforms

The tool is listed for Linux, macOS, Windows, web, and self-hosted use. The installation requirements point toward a locally managed setup, so it is a better fit for users comfortable with that approach than for anyone seeking a conventional mobile app. Gmail is the only supported email provider.

Who it's for

Choose it if you use Gmail, want several kinds of bulk cleanup in one tool, and are comfortable creating credentials and managing a local installation. It is especially suitable for people who value the maker's local-running approach and want filters more specific than a simple unsubscribe action. Look elsewhere if you want setup handled for you, another email provider, or responsive issue support as a priority.

Pros and cons

Pros: Broad bulk actions cover unsubscribe, delete, archive, read status, importance, and labels, with filters to target messages more carefully.

Pros: The maker says the app runs locally without external servers or data collection, and users manage their own OAuth app.

Cons: Docker or Python 3.9+ with uv and user-created Google credentials make initial setup more involved than connecting to a hosted service.

Cons: Gmail-only support rules out users managing other providers, and issue or pull-request responses may be delayed.

Cons: Deletion sends mail to Trash, where it can be recovered within 30 days, rather than permanently removing it at once.

Alternatives

For more email-cleanup options, browse Email Cleanup Software.

Clean Email is a stronger fit for users who want Android or iOS access or prefer a freemium service with a free account capped at 1,000 messages; its free tier omits Screener, Sender and Mailing List Settings, and Auto Clean.

Cleanfox suits users looking for a free Android, iOS, or web option focused on inbox cleaning and newsletter unsubscribing.

Gmail Unsubscriber is another free option for users who want an open-source project with an MIT License and Android, iOS, or web platforms.

GoodByEmail may fit users looking for a freemium service on macOS, Windows, or self-hosted platforms rather than this Gmail-only utility.

InboxSweeper is a free, open-source alternative for users seeking Linux, macOS, web, or Windows support without an account or subscription.

Paperweight is worth considering for users who want a freemium option on Linux, macOS, or Windows whose maker says the MIT-licensed code can be inspected or built.

Unroll.Me is a free Android, iOS, or web option, but it requires access to commercial emails and uses commercial-email data for measurement products.

Leave Me Alone is another option for Android or web users who prefer a paid service with a free plan.

Verdict

Choose Gmail Bulk Unsubscribe & Cleanup Tool if you want a free, locally run Gmail cleanup tool with more than unsubscribe controls and can handle credential setup yourself. Its breadth and local-running model are the main reasons to choose it; the setup burden, Gmail-only scope, and potentially delayed support are good reasons to look elsewhere.

Verdict

This free tool offers a broad set of Gmail cleanup actions, but setup involves user-managed credentials and local installation requirements. Deleted messages go to Trash rather than disappearing immediately.

Where Specifiction places it

Alternatives to Gmail Bulk Unsubscribe & Cleanup ToolAll alternatives →