gmail-watcher — community gmail-watcher, Personal-AI-Employee-Hackathon-0, community, ide skills, Claude Code, Cursor, Windsurf

v0.1.0
GitHub

About this Skill

Ideal for Email Management Agents requiring automated Gmail monitoring and classification capabilities. Monitor Gmail for unread important emails and create action files in /Needs_Action with email metadata and classification.

misha-jatt misha-jatt
[0]
[0]
Updated: 3/2/2026

Killer-Skills Review

Decision support comes first. Repository text comes second.

Reference-Only Page Review Score: 7/11

This page remains useful for operators, but Killer-Skills treats it as reference material instead of a primary organic landing page.

Original recommendation layer Concrete use-case guidance Explicit limitations and caution Locale and body language aligned
Review Score
7/11
Quality Score
47
Canonical Locale
en
Detected Body Locale
en

Ideal for Email Management Agents requiring automated Gmail monitoring and classification capabilities. Monitor Gmail for unread important emails and create action files in /Needs_Action with email metadata and classification.

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.

Ideal Agent Persona

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

↓ 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

Why this page is reference-only

  • - The underlying skill quality score is below the review floor.

Source Boundary

The section below is imported from the upstream repository and should be treated as secondary evidence. Use the Killer-Skills review above as the primary layer for fit, risk, and installation decisions.

After The Review

Decide The Next Action Before You Keep Reading Repository Material

Killer-Skills should not stop at opening repository instructions. It should help you decide whether to install this skill, when to cross-check against trusted collections, and when to move into workflow rollout.

Install Path

Start With Installation And Validation

If this skill is worth continuing with, the next step is to confirm the install command, CLI write path, and environment validation.
Trusted Recheck

Cross-Check Against Trusted Picks

If you are still comparing multiple skills or vendors, go back to the trusted collection before amplifying repository noise.
Workflow

Move To Workflow Collections For Team Rollout

When the goal shifts from a single skill to team handoff, approvals, and repeatable execution, move into workflow collections.
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

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. Monitor Gmail for unread important emails and create action files in /Needs_Action with email metadata and classification.

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.

! Reference-Only Mode

This page remains useful for installation and reference, but Killer-Skills no longer treats it as a primary indexable landing page. Read the review above before relying on the upstream repository instructions.

Upstream Repository Material

The section below is imported from the upstream repository and should be treated as secondary evidence. Use the Killer-Skills review above as the primary layer for fit, risk, and installation decisions.

Upstream Source

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
Upstream Repository Material
The section below is imported from the upstream repository and should be treated as secondary evidence. Use the Killer-Skills review above as the primary layer for fit, risk, and installation decisions.
Supporting Evidence

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/

Related Skills

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

View All

openclaw-release-maintainer

Logo of openclaw
openclaw

Your own personal AI assistant. Any OS. Any Platform. The lobster way. 🦞

★ 333.8k
⑂ 0
AI

widget-generator

Logo of f
f

Generate customizable widget plugins for the prompts.chat feed system

★ 149.6k
⑂ 0
AI

flags

Logo of vercel
vercel

The React Framework

★ 138.4k
⑂ 0
Browser

pr-review

Logo of pytorch
pytorch

Tensors and Dynamic neural networks in Python with strong GPU acceleration

★ 98.6k
⑂ 0
Developer