Zum Inhalt springen
TakoAPI
Zurück zu den Skills

gmail-cleaner

von cedarscy

Web & Frontend Development
286Downloadzahlen laut clawskills.sh
0Aufrufe
0 LikesMelde dich an, um diesen Skill zu liken
—Noch nicht bewertet
Deine Bewertung

Kurzbeschreibung

Clean and organize Gmail accounts in bulk.

Beschreibung

Was dieser Skill macht

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.

Wann du ihn einsetzt

  • 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

Beispiel-Workflow

EINGABE

User asks: Clean my Gmail — trash all promotional emails older than 30 days and set up labels for banking and work

AGENT
  1. 1

    Runs auth.py with --scopes settings to authenticate and obtain an OAuth token

  2. 2

    Runs scan.py to sample the inbox and identify top senders and category counts

  3. 3

    Runs clean.py with --query 'category:promotions older_than:30d' and --dry-run to preview matches

  4. 4

    Runs clean.py without --dry-run to move matching emails to trash

  5. 5

    Runs organize.py to create Banking and Work labels and set up inbox filters

AUSGABE

Promotional emails moved to trash and Banking/Work labels created with active filters for future emails

Voraussetzungen

  • Google Cloud project with Gmail API enabled
  • OAuth 2.0 credentials JSON (Desktop app type) downloaded from Google Cloud Console

Installation

clawhub install cedarscy/gmail-cleaner

Führe den CLI-Befehl aus oder füge den Prompt in Claude Code, Cursor, Codex oder deinen Coding-Agenten ein.

Links