FREEDOM251

Freedom251 › Email Cleanup Software

Gmail Bulk Unsubscribe & Cleanup Tool

Free plan Open source LinuxMacSelf-hostedWebWindows

Visit Gmail Bulk Unsubscribe & Cleanup Tool Alternatives Pricing

Gmail Bulk Unsubscribe & Cleanup Tool's own site

What Gmail Bulk Unsubscribe & Cleanup Tool is

Gmail Bulk Unsubscribe & Cleanup Tool helps Gmail users manage unwanted messages in batches. It can unsubscribe through automatic one-click or manual methods, delete mail from multiple senders, archive messages, manage labels, and mark messages as read or important. Users can also export email metadata as CSV. Filters include date range, email size, category, sender, and labels. The tool uses the Gmail API, and users must create their own Google Cloud project and OAuth credentials. Its maker says the software runs locally without external servers or data collection, and describes its requested access as read and modify permissions. Setup requires Docker or Python 3.9+ with uv, along with the user's own Google credentials. The tool is free under the MIT license. Deleted messages go to Gmail Trash and can be recovered there within 30 days. A one-on-one setup service is listed at $8, paid once for guided installation help. The maker notes that replies to issues and pull requests may be delayed.

Who it suits

This tool suits Gmail users comfortable setting up a local application and their own Google credentials. People who need installation help can use the listed one-on-one setup service.

What it does well

  • Supports automatic and manual unsubscribe methods.
  • Bulk actions include deleting, archiving, and labeling.
  • Filters cover date, size, category, sender, and labels.
  • The maker says email stays on the user's machine.
  • Free to use under the MIT license.

What to know first

  • Users must create their own Google Cloud project and OAuth credentials.
  • Setup requires Docker or Python 3.9+ with uv.
  • Only Gmail is supported.
  • The maker says issue and pull-request replies may be delayed.

Plans

PlanBilled and limitsPrice
Freefree forever · bulk unsubscribe · bulk deletion · archiving · local execution · MIT-licensed open sourceFree
1-on-1 Setup Serviceone-time setup session · Google Meet guidance · Docker/Google Cloud/credentials help · under-20-minute target$8, paid once

As gururagavendra.github.io lists them, read 15 Oct 2026. The maker's own page has the final word.

Getting started

  1. Open the tool's website.
  2. Create your own Google Cloud project and OAuth credentials.
  3. Prepare Docker or Python 3.9+ with uv.
  4. Supply your Google credentials to run the tool.
  5. Use the one-on-one setup service for guided help if needed.

Overview

Gmail Bulk Unsubscribe & Cleanup Tool is a Gmail utility for unsubscribing and managing messages in bulk. It suits users comfortable preparing a local installation and configuring their own Google credentials. Its range of cleanup actions comes without a subscription, but setup and account access require care.

Key features

Users can unsubscribe automatically with one click or handle unsubscribe requests manually, then delete messages from multiple senders, archive them, or mark them read or important. Filters for date range, message size, category, sender, and labels help target actions instead of applying them across an inbox indiscriminately. Label management and CSV downloads of email metadata make it useful for broader mailbox housekeeping, not just newsletter cleanup.

The tool uses the Gmail API and requests read and modify access. Its maker says it runs locally without external servers or data collection, and users control their own Google OAuth app. That approach may suit people who want to keep processing on their machine, though it still means creating a Google Cloud project and supplying credentials. Deleted messages go to Gmail Trash and can be recovered there within 30 days.

Pricing

PlanPriceWhat it includes
FreefreeFree to use under the MIT license, with no subscription.
1-on-1 Setup Service$8, paid oncePersonal setup help via Google Meet, guided until installation works.

The free plan is the natural choice for technically confident users who can install the tool and configure credentials themselves. There is no subscription or trial; the one-time setup service is for people who want help with Docker, Google Cloud Console, or credentials.json. It addresses installation friction rather than adding a different cleanup tier.

Installation requires Docker or Python 3.9+ with uv, plus user-supplied Google credentials. The maker cautions that responses to issues and pull requests may be delayed while taking personal time, so users who need prompt support should weigh that before relying on the tool.

Platforms

The tool supports Linux, macOS, Windows, web, and self-hosted use. The stated setup requirements mean it is most compelling for people comfortable with a local or self-hosted workflow, rather than those seeking a ready-to-use mobile app.

Who it's for

Choose it if you use Gmail, want several kinds of bulk cleanup in one tool, and are willing to manage OAuth credentials and installation. It is less suitable for users who want minimal setup, hands-off account connection, or responsive support; the requested read and modify access also deserves consideration before connecting an account.

Pros and cons

Pros

  • Broad Gmail cleanup: Unsubscribing, bulk deletion, archiving, label management, marking mail read or important, and CSV metadata export cover more than mailing-list removal.
  • Targeted actions: Date, size, category, sender, and label filters help constrain bulk changes.
  • No subscription: The free tool is offered under the MIT license, and deleted mail remains recoverable from Trash for 30 days.
  • Local processing claim: The maker says there are no external servers or data collection, while users control their own OAuth app.

Cons

  • Technical setup: Users must prepare Docker or Python 3.9+ with uv and create a Google Cloud project with their own credentials.
  • Sensitive access: Read and modify permissions are required, so users must be comfortable granting that access.
  • Support uncertainty: The maker may be delayed in responding to issues and pull requests.

Alternatives

  • Email Cleanup Software is the directory's broader category for comparing mailbox cleanup options.
  • Clean Email may fit users who prefer Android, iOS, macOS, or web access and want a free account capped at 1,000 messages; its free tier excludes Screener, Sender and Mailing List Settings, and Auto Clean.
  • InboxSweeper is another free option across Linux, macOS, web, and Windows, with no account or subscription.
  • Cleanfox is a free Android, iOS, and web choice for inbox cleaning and newsletter unsubscribing.
  • Trimbox may suit mobile or browser-extension users who want to try unsubscribing, with the first 10 unsubscribes free.
  • Unroll.Me is a free Android, iOS, and web option, but requires access to commercial emails and uses commercial-email data for measurement products.
  • ClearInbox offers a free account on web or self-hosted platforms for users seeking another mailbox cleanup option.
  • Unsubscribe for Gmail is a freemium alternative for Android, iOS, web, or browser extension.
  • GoodByEmail is a freemium alternative for macOS, Windows, or self-hosted use, with a free trial.

Verdict

Gmail Bulk Unsubscribe & Cleanup Tool is a good fit for technically capable Gmail users who want varied bulk actions without subscription costs and value the maker's local-running approach. Its main trade-off is the work and responsibility of configuring credentials for read and modify access; users who want a simpler setup or more dependable support should look elsewhere.

Verdict

The tool offers several Gmail cleanup actions without a subscription, but setup requires technical preparation and user-supplied credentials. Check its requested read and modify access before connecting a Google account.

Questions

How much does the tool cost?

The software is free under the MIT license. A one-on-one setup service costs $8, paid once.

Is there a free plan or trial?

There is a free plan and no free trial.

Which email provider does it support?

It supports Gmail through the Gmail API.

What do I need to set it up?

You need Docker or Python 3.9+ with uv, plus your own Google Cloud project and OAuth credentials.

What access does it request, and where does email data go?

The repository describes read and modify permissions. The maker says the app runs locally without external servers or data collection.

Can deleted messages be recovered?

Deleted messages go to Gmail Trash and can be recovered there within 30 days.

Facts from Gmail Bulk Unsubscribe & Cleanup Tool's own pages

API and SDKs
Documentation explains using the Gmail API but does not present a separate public product API or SDK. · github.com, 15 Oct 2026
Archiving
Selected senders' messages can be archived to remove them from the inbox. · github.com, 15 Oct 2026
Batch performance
The project says Gmail API batch requests process 100 emails per API call. · github.com, 15 Oct 2026
Bulk unsubscribe
The tool finds newsletters and supports both automatic one-click and manual unsubscribe methods. · gururagavendra.github.io, 15 Oct 2026
Community traction
The GitHub repository page showed about 2.1k stars and 138 forks when opened. · github.com, 15 Oct 2026
CSV export
Email metadata for selected senders can be downloaded as CSV. · github.com, 15 Oct 2026
Delete by sender
Users can identify heavy senders and delete their messages in bulk. · github.com, 15 Oct 2026
Deletion limit
Deleted messages go to Gmail Trash and can be recovered there within 30 days. · github.com, 2 Oct 2026
Documentation and support
Setup instructions, FAQ, advanced configuration, troubleshooting, video guidance, GitHub issues and contribution instructions are provided. · github.com, 15 Oct 2026
Filters
Filters include date range, email size, category, sender, and labels. · github.com, 2 Oct 2026
Importance control
Users can mark or unmark messages from selected senders as important. · github.com, 15 Oct 2026
Independent description
An external Chinese-language tools site described the project as free, open source, local and deployable through Docker or Python. · ahhhhfs.com, 15 Oct 2026
Independent feature summary
The same external write-up highlighted unsubscribe, sender deletion, bulk read marking, filters, local privacy and Gmail API batching. · ahhhhfs.com, 15 Oct 2026
Independent platform summary
The external write-up listed Docker and Python deployment on Linux, Windows, Intel macOS and Apple Silicon macOS. · ahhhhfs.com, 15 Oct 2026
Integration
The tool uses the Gmail API and requires users to create their own Google Cloud project and OAuth credentials. · github.com, 2 Oct 2026
Integrations
The documented external integration is the Gmail API. · github.com, 15 Oct 2026
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. · github.com, 2 Oct 2026
Interface
The repository describes a Gmail-style interface with real-time progress tracking. · github.com, 15 Oct 2026
Label management
The interface can create, delete, apply and remove Gmail labels for sender-selected mail. · github.com, 15 Oct 2026
Licence
The repository and product footer identify the licence as MIT. · github.com, 15 Oct 2026
Limit: bulk-delete bug
A Reddit user reported an “Error: undefined” failure when deleting multiple emails, while one-by-one deletion worked. · reddit.com, 15 Oct 2026
Limit: Gmail-only demand
Reddit users asked for Hotmail/Live and other-provider support, indicating the published tool is focused on Gmail. · reddit.com, 15 Oct 2026
Limit: missing automation
Reddit users requested scheduled deletion, broader provider support and an API for automation. · reddit.com, 15 Oct 2026
Limit: OAuth complexity
Reddit discussion included confusion and errors around remote-server OAuth, localhost use and credentials setup. · reddit.com, 15 Oct 2026

Where Gmail Bulk Unsubscribe & Cleanup Tool stands on Freedom251

Look at these too