Skip to content

Add gmail-inbox-cleaner to partner-built#156

Open
siddhantkalra wants to merge 2 commits intoanthropics:mainfrom
siddhantkalra:add-gmail-inbox-cleaner
Open

Add gmail-inbox-cleaner to partner-built#156
siddhantkalra wants to merge 2 commits intoanthropics:mainfrom
siddhantkalra:add-gmail-inbox-cleaner

Conversation

@siddhantkalra
Copy link
Copy Markdown

What this adds

gmail-inbox-cleaner — a systematic Gmail inbox overhaul plugin for Claude Cowork.

Why

Gmail cleanup is one of the most common productivity requests. Existing approaches (bulk-delete by category, manual sorting) either nuke important emails or take forever. This plugin gives Claude a structured, safe methodology: read everything first, then act with user approval at each step.

How it works

Four-stage workflow:

  1. Preparation — tool check, full inbox audit (ALL subject lines read, then email bodies for ambiguous senders), unread review with actionable surfacing
  2. Action — bulk delete by Claude's content analysis (never by Gmail category), then sender-by-sender review loop with persistent state for session recovery
  3. Future Proofing — label/filter system derived from the review (not pre-defined), unsubscribe sweep with platform-specific methods
  4. Safety Review — bin audit for false positives, restore plan presented before execution, final report

What's included

  • 4 slash commands: /gmail-prepare, /gmail-cleanup, /gmail-future-proof, /gmail-bin-audit
  • 8 Python scripts for Gmail API operations (OAuth, batch actions, filter/label management, accurate trash search, unsubscribe URL extraction)
  • Gmail MCP connector with 3-tier graceful degradation (MCP only → + Claude in Chrome → + Python API)
  • Decision framework and unsubscribe pattern references
  • Persistent state files for session recovery across timeouts

Key design decisions

  • Never delete by Gmail category — important emails land in Promotions/Social regularly
  • Sender-first architecture — see the full relationship before deciding, not sequential time-order batches
  • User approves every bulk action — Claude presents a plan, user confirms
  • Bin audit before emptying trash — catches false positives from bulk delete before they're permanent

Systematic Gmail inbox overhaul plugin for Claude Cowork.

Four-stage methodology:
- Preparation: tool check, full audit (all subject lines + bodies), unread review
- Action: bulk delete by content analysis, sender-by-sender review loop
- Future Proofing: label/filter system, unsubscribe sweep
- Safety Review: bin audit, restore plan, final report

Includes:
- 8 Python scripts for Gmail API operations (OAuth, batch actions, filter/label management, trash search, unsubscribe URL extraction)
- 4 slash commands (/gmail-prepare, /gmail-cleanup, /gmail-future-proof, /gmail-bin-audit)
- Gmail MCP connector with 3-tier graceful degradation
- Decision framework and unsubscribe pattern references
…metadata

- Replaced placeholder README with full methodology documentation:
  the problem with category-based deletion, two-pass reading approach,
  sender-first architecture and why it matters, the flag system,
  filter system derived from review data, unsubscribe sweep logic,
  bin audit rationale, tool tier model
- Updated plugin.json repo URL to correct self-hosted repo
- Synced all files with latest version of plugin
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant