Skip to content
SPECIFICTION
Get listed

Gmail Cleanup

github.com

Web
Visit github.com
Spec score 7.0 #28 of 31 in Email Cleanup Software

Spec sheet

Purpose
Gmail Cleanup is a Google Apps Script for automated Gmail inbox cleanup and mass unsubscribe.Read 11 Oct 2026 · github.com
Integrations
Setup uses Google Apps Script, the Gmail API, and a Google Sheet created in Google Drive for logs and editable sender lists.Read 4 Oct 2026 · github.com
License
The repository is distributed under the MIT license.Read 11 Oct 2026 · github.com
Automation
Optional time-based triggers can run cleanup daily and unsubscribe every three days.Read 11 Oct 2026 · github.com
Cleanup
By default, it unsubscribes from and moves promotions and newsletters older than one day to Trash, and moves spam to Trash.Read 11 Oct 2026 · github.com
Default actions
By default, it unsubscribes and moves promotions and newsletters older than one day to Trash, and moves spam to Trash.Read 4 Oct 2026 · github.com
Detection
It targets Gmail's Promotions category, newsletter subject or label patterns, and sender patterns such as noreply and marketing.Read 11 Oct 2026 · github.com
Integration
Setup instructions require creating a project in Google Apps Script and enabling the Gmail API; the script also uses Google Sheets and Drive.Read 11 Oct 2026 · github.com
Limit
The README warns that sender-pattern searches may match legitimate transactional messages and recommends excluding domains and running dryRun first.Read 4 Oct 2026 · github.com
Logging
The script creates a Google Sheet that records unsubscribe attempts and skipped senders, and provides editable excluded-sender and unsubscribe-only lists.Read 11 Oct 2026 · github.com
Notable limit
The README cautions that sender-pattern searches can match legitimate transactional email and recommends whitelisting domains and running dryRun first.Read 11 Oct 2026 · github.com
Preview
A dry-run mode previews what would be deleted before cleanup runs.Read 11 Oct 2026 · github.com
Preview and logging
Dry-run mode previews actions, and unsubscribe attempts are logged in a Google Sheet.Read 4 Oct 2026 · github.com
Protection
Keyword detection in English and Spanish is used to protect potentially important health, government, immigration, legal, education, and transactional emails in ambiguous searches.Read 11 Oct 2026 · github.com
Recoverability
The README says messages moved to Trash are recoverable for 30 days and permanent deletion is off by default.Read 11 Oct 2026 · github.com
Sender controls
Users can exclude senders from cleanup or unsubscribe from them while keeping their emails, using script settings or Google Sheet tabs.Read 11 Oct 2026 · github.com
Unsubscribe
It parses List-Unsubscribe headers and supports HTTP one-click and mailto unsubscribe endpoints.Read 11 Oct 2026 · github.com

Where Specifiction places it

Alternatives to Gmail CleanupAll alternatives →