gmail-agent
by r39132
Web & Frontend DevelopmentBrief
Summarize unread Gmail, show folder structure, audit/clean labels, and purge spam/trash.
Description
What This Skill Does
Manages a Gmail inbox by summarizing unread messages, displaying the full label hierarchy with message counts, purging spam and trash, and auditing or cleaning specific label trees.
Combines inbox summarization, label auditing, and folder cleanup into one agent so you don't need to open a browser or run multiple tools separately.
When to Use It
- Check what's new in your inbox each morning
- See a breakdown of all Gmail labels and folder sizes
- Bulk-delete accumulated spam and trash
- Audit a label hierarchy before removing old categories
- Run a daily scheduled summary and inbox cleanup
Example Workflow
User asks: Summarize my unread emails
- 1
Searches Gmail for unread inbox messages using gog
- 2
Fetches full message details for any items needing more context
- 3
Groups messages by sender when multiple arrive from the same address
- 4
Formats results into a structured summary with sender, subject, and date
A grouped list of unread inbox messages; if over 20 messages, a per-sender count breakdown instead
Requirements
- gog binary installed
- GMAIL_ACCOUNT environment variable set to your Gmail address
Installation
clawhub install r39132/gmail-agentRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.