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