gmail-skill
by r39132
Web & Frontend DevelopmentBrief
Gmail automation: summarize, labels, spam purge, filing, deletion, permanent delete.
Description
What This Skill Does
Automates Gmail inbox management: summarizing unread messages, purging spam and trash, managing labels, filing messages, and deleting old emails by date. Long-running operations run as background daemons and report results via WhatsApp when complete.
Background execution daemonizes long cleanup tasks so they complete independently even if the agent session times out.
When to Use It
- Reviewing a morning summary of unread inbox messages
- Purging spam and trash folders on a weekly schedule
- Moving newsletters from inbox into a dedicated label
- Deleting an old project label along with all its messages
- Removing emails older than a set date from a specific folder
Example Workflow
User asks: Clean out my spam and trash folders
- 1
Wraps gmail-cleanup.sh in the background task daemon using the user's GMAIL_ACCOUNT
- 2
Background process starts and returns immediately without blocking the agent
- 3
Script purges all messages from spam and trash via Gmail API
- 4
Progress updates are sent every 30 seconds; final counts delivered when done
Spam and trash folders emptied with actual purged message counts reported via WhatsApp
Requirements
- GMAIL_ACCOUNT environment variable set to your Gmail address
- gog binary installed
Installation
clawhub install r39132/gmail-skillRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.