Gmail Cleanup

What it does

Automation

Optional time-based triggers can run cleanup daily and unsubscribe every three days.checked 11 Oct 2001

Cleanup

By default, it unsubscribes from and moves promotions and newsletters older than one day to Trash, and moves spam to Trash.checked 11 Oct 2001

Default actions

By default, it unsubscribes and moves promotions and newsletters older than one day to Trash, and moves spam to Trash.checked 4 Oct 2001

Detection

It targets Gmail's Promotions category, newsletter subject or label patterns, and sender patterns such as noreply and marketing.checked 11 Oct 2001

Integration

Setup instructions require creating a project in Google Apps Script and enabling the Gmail API; the script also uses Google Sheets and Drive.checked 11 Oct 2001

Integrations

Setup uses Google Apps Script, the Gmail API, and a Google Sheet created in Google Drive for logs and editable sender lists.checked 4 Oct 2001

License

The repository is distributed under the MIT license.checked 11 Oct 2001

Limit

The README warns that sender-pattern searches may match legitimate transactional messages and recommends excluding domains and running dryRun first.checked 4 Oct 2001

Logging

The script creates a Google Sheet that records unsubscribe attempts and skipped senders, and provides editable excluded-sender and unsubscribe-only lists.checked 11 Oct 2001

Notable limit

The README cautions that sender-pattern searches can match legitimate transactional email and recommends whitelisting domains and running dryRun first.checked 11 Oct 2001

Preview

A dry-run mode previews what would be deleted before cleanup runs.checked 11 Oct 2001

Preview and logging

Dry-run mode previews actions, and unsubscribe attempts are logged in a Google Sheet.checked 4 Oct 2001

Protection

Keyword detection in English and Spanish is used to protect potentially important health, government, immigration, legal, education, and transactional emails in ambiguous searches.checked 11 Oct 2001

Purpose

Gmail Cleanup is a Google Apps Script for automated Gmail inbox cleanup and mass unsubscribe.checked 11 Oct 2001

Recoverability

The README says messages moved to Trash are recoverable for 30 days and permanent deletion is off by default.checked 11 Oct 2001

Sender controls

Users can exclude senders from cleanup or unsubscribe from them while keeping their emails, using script settings or Google Sheet tabs.checked 11 Oct 2001

Unsubscribe

It parses List-Unsubscribe headers and supports HTTP one-click and mailto unsubscribe endpoints.checked 11 Oct 2001