Freedom251 › Email Cleanup Software
Gmail Bulk Unsubscribe & Cleanup Tool
Visit Gmail Bulk Unsubscribe & Cleanup Tool Alternatives Pricing

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
| Plan | Billed and limits | Price |
|---|---|---|
| Free | free forever · bulk unsubscribe · bulk deletion · archiving · local execution · MIT-licensed open source | Free |
| 1-on-1 Setup Service | one-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
- Open the tool's website.
- Create your own Google Cloud project and OAuth credentials.
- Prepare Docker or Python 3.9+ with uv.
- Supply your Google credentials to run the tool.
- 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
| Plan | Price | What it includes |
|---|---|---|
| Free | free | Free to use under the MIT license, with no subscription. |
| 1-on-1 Setup Service | $8, paid once | Personal 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
- Email Cleanup Software#1 of 31