- Home
- Email Cleanup Software
- Gmail Bulk Unsubscribe & Cleanup Tool
Gmail Bulk Unsubscribe & Cleanup Tool
What it is
Gmail Bulk Unsubscribe & Cleanup Tool helps Gmail users manage unwanted messages in batches. It supports automatic one-click and manual unsubscribe methods, bulk deletion from multiple senders, archiving, label management, and marking messages as read or important. Users can also download email metadata as CSV. Filters cover date range, email size, category, sender, and labels. The tool uses the Gmail API, and setup requires users to create their own Google Cloud project and OAuth credentials. It can run locally; the maker says it uses no external servers or data collection, so email stays on the user's machine. The repository describes its requested access as read and modify permissions and says users control their own Google OAuth app. Running it requires Docker or Python 3.9+ with uv, as well as the user's own Google credentials. The software is free to use 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 responses to issues and pull requests may be delayed while taking personal time.
For and against
For
- Supports automatic and manual unsubscribe methods.
- Filters by date, size, category, sender, and labels.
- Runs locally, according to its maker.
- Deleted messages remain recoverable in Gmail Trash for 30 days.
- Free under the MIT license.
Against
- Requires users to create Google Cloud and OAuth credentials.
- Setup requires Docker or Python 3.9+ with uv.
- Supports Gmail only.
- Issue and pull-request responses may be delayed.
The verdict
The tool offers batch cleanup actions and filtering, but it requires users to arrange their own credentials and local setup. Its listed optional setup service costs $8, paid once.
Who it suits
It suits Gmail users who want to unsubscribe or clean up messages in batches and are comfortable configuring Google API access. Users who need installation help can consider the listed one-on-one setup service.
Plans and prices
Free
bulk unsubscribe · bulk deletion · archiving · local execution
Read 15 Oct 2026 · github.com
1-on-1 Setup Service
Google Meet guidance · Docker/Google Cloud/credentials help · under-20-minute target
Read 15 Oct 2026 · github.com
On the record
- API and SDKs
- Documentation explains using the Gmail API but does not present a separate public product API or SDK.github.com · read 15 Oct 2026
- Archiving
- Selected senders' messages can be archived to remove them from the inbox.github.com · read 15 Oct 2026
- Batch performance
- The project says Gmail API batch requests process 100 emails per API call.github.com · read 15 Oct 2026
- Bulk unsubscribe
- The tool finds newsletters and supports both automatic one-click and manual unsubscribe methods.gururagavendra.github.io · read 15 Oct 2026
- Community traction
- The GitHub repository page showed about 2.1k stars and 138 forks when opened.github.com · read 15 Oct 2026
- CSV export
- Email metadata for selected senders can be downloaded as CSV.github.com · read 15 Oct 2026
- Delete by sender
- Users can identify heavy senders and delete their messages in bulk.github.com · read 15 Oct 2026
- Deletion limit
- Deleted messages go to Gmail Trash and can be recovered there within 30 days.github.com · read 2 Oct 2026
- Documentation and support
- Setup instructions, FAQ, advanced configuration, troubleshooting, video guidance, GitHub issues and contribution instructions are provided.github.com · read 15 Oct 2026
- Filters
- Filters include date range, email size, category, sender, and labels.github.com · read 2 Oct 2026
- Importance control
- Users can mark or unmark messages from selected senders as important.github.com · read 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 · read 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 · read 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 · read 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 · read 2 Oct 2026
- Integrations
- The documented external integration is the Gmail API.github.com · read 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 · read 2 Oct 2026
- Interface
- The repository describes a Gmail-style interface with real-time progress tracking.github.com · read 15 Oct 2026
