Gmail Organizer

Desktop Gmail Automation

Keep your inbox clean with smart labels and safe automation.

Gmail Organizer helps you classify emails with keyword rules, selectively archive low-risk categories, and relabel mistakes in bulk.

Get Started View Source

What you get

  • Rule-based email labeling
  • Selective auto-archive by label
  • Interactive preview with row selection
  • Relabel workflow for corrections
  • Background scheduling every 2-4 hours

Features

Preview First

See exactly what will change before applying updates to Gmail.

Selective Auto-Archive

Archive only safe labels like Newsletters and Shopping, keep important labels in inbox.

Relabel Correction Mode

Pick a label, re-run filters, and migrate incorrectly labeled emails to the right destination.

Undo History

Every run is tracked so you can recover from mistakes quickly.

Typical workflow

  1. Connect Gmail once (OAuth).
  2. Tune keyword rules in data/gmail_rules.json.
  3. Run Preview, deselect anything uncertain, then Apply.
  4. Use Relabel mode to fix misclassified emails.
  5. Schedule headless runs every 2-4 hours via Task Scheduler.

Run locally

python -m pip install -r requirements.txt
python gmail_app.py

# Optional headless scheduler run
python gmail_run_once.py
powershell -ExecutionPolicy Bypass -File .\schedule_gmail_task.ps1 -EveryHours 3