Gmail Cleaner

Bulk Gmail cleanup using the Gmail API. Processes 1000 messages per API call.

Prerequisites

• google-api-python-client, google-auth-oauthlib Python packages (scripts auto-install if missing)
• OAuth credentials JSON from Google Cloud Console (Desktop app type)
• Token files stored as .pkl files per account

Workflow

1. Auth (first time or new account)

python scripts/auth.py --credentials /path/to/credentials.json --token /path/to/token.pkl --scopes settings