gmail-cleaner
cedarscy द्वारा
Web & Frontend Developmentसंक्षिप्त
Clean and organize Gmail accounts in bulk.
विवरण
यह स्किल क्या करती है
Bulk-cleans Gmail accounts using the Gmail API. Supports trashing or permanently deleting emails by sender or search query, creating labels, setting up auto-filters, and restoring emails from trash. Multiple accounts are handled via separate OAuth token files.
Processes up to 1000 messages per API call with dry-run support, so large inbox cleanups are faster and safer than working through Gmail's web interface.
इसे कब इस्तेमाल करें
- Bulk deleting promotional emails older than 30 days
- Removing all emails from a specific newsletter or spam sender
- Setting up auto-filters to label incoming banking or work emails
- Scanning an inbox to identify top senders before cleaning
- Restoring accidentally trashed emails and applying a label
उदाहरण वर्कफ़्लो
User asks: Clean my Gmail — trash all promotional emails older than 30 days and set up labels for banking and work
- 1
Runs auth.py with --scopes settings to authenticate and obtain an OAuth token
- 2
Runs scan.py to sample the inbox and identify top senders and category counts
- 3
Runs clean.py with --query 'category:promotions older_than:30d' and --dry-run to preview matches
- 4
Runs clean.py without --dry-run to move matching emails to trash
- 5
Runs organize.py to create Banking and Work labels and set up inbox filters
Promotional emails moved to trash and Banking/Work labels created with active filters for future emails
आवश्यकताएँ
- Google Cloud project with Gmail API enabled
- OAuth 2.0 credentials JSON (Desktop app type) downloaded from Google Cloud Console
इंस्टॉलेशन
clawhub install cedarscy/gmail-cleanerCLI कमांड चलाएँ, या प्रॉम्प्ट को Claude Code, Cursor, Codex या जो भी कोडिंग एजेंट आप इस्तेमाल करते हैं उसमें पेस्ट करें।