Skip to content
TakoAPI
Back to skills

gmail-agent

by r39132

Web & Frontend Development
—Not yet rated
Your rating

Brief

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

INPUT

User asks: Summarize my unread emails

AGENT
  1. 1

    Searches Gmail for unread inbox messages using gog

  2. 2

    Fetches full message details for any items needing more context

  3. 3

    Groups messages by sender when multiple arrive from the same address

  4. 4

    Formats results into a structured summary with sender, subject, and date

OUTPUT

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-agent

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links