gmail-watcher — gmail api monitoring gmail-watcher, Personal-AI-Employee-Hackathon-0, community, gmail api monitoring, ide skills, automated email classification, gmail-watcher install, Claude Code, Cursor, Windsurf

v0.1.0
GitHub

About this Skill

Ideal for Email Management Agents requiring automated Gmail monitoring and classification capabilities. gmail-watcher is a skill that automates Gmail monitoring by polling the Gmail API for unread important messages and organizing them into .md files.

Features

Polls Gmail API for unread important messages
Filters out already-processed message IDs using deduplication
Creates .md files in /Needs_Action for classified emails
Triggers on commands like 'check gmail' and 'monitor emails'
Outputs a list of new emails after polling the Gmail API
Supports classification of emails based on importance

# Core Topics

gmail api monitoring automated email classification gmail-watcher install
misha-jatt misha-jatt
[0]
[0]
Updated: 3/2/2026

Agent Capability Analysis

The gmail-watcher skill by misha-jatt is an open-source community AI agent skill for Claude Code and other IDE workflows, helping agents execute tasks with better context, repeatability, and domain-specific guidance. Optimized for gmail api monitoring, automated email classification, gmail-watcher install.

Ideal Agent Persona

Ideal for Email Management Agents requiring automated Gmail monitoring and classification capabilities.

Core Value

Empowers agents to poll the Gmail API for unread important emails, classify them, and create .md files in /Needs_Action using the Gmail API and Markdown file format, enhancing their email management superpower.

↓ Capabilities Granted for gmail-watcher

Automating email classification and organization
Generating Markdown files for important emails
Monitoring Gmail accounts for new unread messages

! Prerequisites & Limits

  • Requires Gmail API access
  • Limited to unread important emails
  • Creates files in a specific /Needs_Action directory
Labs Demo

Browser Sandbox Environment

⚡️ Ready to unleash?

Experience this Agent in a zero-setup browser environment powered by WebContainers. No installation required.

Boot Container Sandbox

gmail-watcher

Install gmail-watcher, an AI agent skill for AI agent workflows and automation. Works with Claude Code, Cursor, and Windsurf with one-command setup.

SKILL.md
Readonly

Gmail Watcher

Polls Gmail API for unread important emails, classifies them, and creates .md files in /Needs_Action.

Triggers

Use this skill when:

  • "check gmail"
  • "monitor emails"
  • "watch gmail"
  • "check for new emails"
  • "start gmail watcher"

Quick Reference

StepActionOutput
1. PollQuery Gmail API for unread important messagesList of new emails
2. DedupFilter out already-processed message IDsNew messages only
3. ClassifyRun classifier on subject + snippetCategory + priority
4. CreateWrite .md to /Needs_Action with frontmatterEMAIL_*.md file
5. NotifySlack notification + Calendar event (if due date)Notifications sent
6. LogAudit entry to /Logs/YYYY-MM-DD.jsonJSON log line

Process

Step 1: Poll Gmail

Query Gmail API with is:unread is:important (configurable via GMAIL_QUERY env var).

For each unread important message:
  - Check if gmail_id already processed → skip
  - Fetch full message (headers, snippet, body)

Step 2: Classify

Use the rule-based classifier on subject + snippet + body:

  • Priority: urgent / high / medium / low
  • Category: Urgent / Work / Personal / Idea
  • Due date: Based on priority offset

Step 3: Create Action File

Write to /Needs_Action/EMAIL_<timestamp>_<subject>.md:

yaml
1---
2type: email
3source: gmail
4gmail_id: "msg_id"
5from: "sender@example.com"
6subject: "Email Subject"
7category: Work
8priority: high
9suggested_due_date: "2026-03-03"
10status: pending
11---

Step 4: Log and Notify

  • Audit log: action_type: "email_processed"
  • Slack: Task processed notification
  • Calendar: Event created if due date assigned

Configuration

Env VarDefaultPurpose
GOOGLE_CREDENTIALS_PATHcredentials.jsonOAuth client secrets
GMAIL_TOKEN_PATHgmail_token.jsonPersisted OAuth token
GMAIL_CHECK_INTERVAL120Poll interval in seconds
GMAIL_QUERYis:unread is:importantGmail search query

Running

bash
1cd watchers
2uv run watch-gmail

Safety

  • Read-only: Uses gmail.readonly scope — never modifies emails
  • DRY_RUN: Logs intent without creating files or calling APIs
  • Retry: 3 attempts per message, then quarantine
  • Never crashes: All API errors caught and logged
  • ALWAYS log every action to /Logs/

FAQ & Installation Steps

These questions and steps mirror the structured data on this page for better search understanding.

? Frequently Asked Questions

What is gmail-watcher?

Ideal for Email Management Agents requiring automated Gmail monitoring and classification capabilities. gmail-watcher is a skill that automates Gmail monitoring by polling the Gmail API for unread important messages and organizing them into .md files.

How do I install gmail-watcher?

Run the command: npx killer-skills add misha-jatt/Personal-AI-Employee-Hackathon-0/gmail-watcher. It works with Cursor, Windsurf, VS Code, Claude Code, and 19+ other IDEs.

What are the use cases for gmail-watcher?

Key use cases include: Automating email classification and organization, Generating Markdown files for important emails, Monitoring Gmail accounts for new unread messages.

Which IDEs are compatible with gmail-watcher?

This skill is compatible with Cursor, Windsurf, VS Code, Trae, Claude Code, OpenClaw, Aider, Codex, OpenCode, Goose, Cline, Roo Code, Kiro, Augment Code, Continue, GitHub Copilot, Sourcegraph Cody, and Amazon Q Developer. Use the Killer-Skills CLI for universal one-command installation.

Are there any limitations for gmail-watcher?

Requires Gmail API access. Limited to unread important emails. Creates files in a specific /Needs_Action directory.

↓ How To Install

  1. 1. Open your terminal

    Open the terminal or command line in your project directory.

  2. 2. Run the install command

    Run: npx killer-skills add misha-jatt/Personal-AI-Employee-Hackathon-0/gmail-watcher. The CLI will automatically detect your IDE or AI agent and configure the skill.

  3. 3. Start using the skill

    The skill is now active. Your AI agent can use gmail-watcher immediately in the current project.

Related Skills

Looking for an alternative to gmail-watcher or another community skill for your workflow? Explore these related open-source skills.

View All

widget-generator

Logo of f
f

f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete privacy.

★ 149.6k
⑂ 0
AI

flags

Logo of vercel
vercel

flags is a Next.js feature management skill that enables developers to efficiently add or modify framework feature flags, streamlining React application development.

★ 138.4k
⑂ 0
Browser

zustand

Logo of lobehub
lobehub

The ultimate space for work and life — to find, build, and collaborate with agent teammates that grow with you. We are taking agent harness to the next level — enabling multi-agent collaboration, effortless agent team design, and introducing agents as the unit of work interaction.

★ 72.8k
⑂ 0
AI

data-fetching

Logo of lobehub
lobehub

The ultimate space for work and life — to find, build, and collaborate with agent teammates that grow with you. We are taking agent harness to the next level — enabling multi-agent collaboration, effortless agent team design, and introducing agents as the unit of work interaction.

★ 72.8k
⑂ 0
AI