gmail-watcher

Monitor unread important Gmail messages and write classified action files to /Needs_Action.

Updated Feb 22, 2026
One-click install
npx skills add https://github.com/misha-jatt/Personal-AI-Employee-Hackathon-0 --skill gmail-watcher
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gmail-watcher
Source: https://github.com/misha-jatt/Personal-AI-Employee-Hackathon-0/tree/main/.agents/skills/gmail-watcher
Command: npx skills add https://github.com/misha-jatt/Personal-AI-Employee-Hackathon-0 --skill gmail-watcher

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Gmail inbox can become overwhelming; this skill automatically monitors unread important emails and creates action files in /Needs_Action with email metadata and classification to streamline triage and work intake.

Core Features & Use Cases

  • Polls Gmail API for unread important messages and identifies new items
  • Classifies messages by priority and category and generates structured action files in /Needs_Action
  • Logs actions and can trigger Slack notifications or calendar entries when due dates are present
  • Use Case: A customer support inbox is transformed into actionable items for the Needs_Action queue, enabling faster response times

Quick Start

Poll Gmail for unread important messages, classify them, and write action files to /Needs_Action.

Frequently Asked Questions about gmail-watcher

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically turn unread Gmail emails into action items?

You can automate Gmail triage by polling the Gmail API for unread important messages, classifying them by subject and body, and generating markdown action files in a Needs_Action directory to streamline your work intake.

What do I need to set up to monitor Gmail and auto-create action files?

Monitoring Gmail to auto-create action files requires OAuth credentials, a configured GMAIL_QUERY environment variable, and write access to a Needs_Action directory to store the generated markdown action items and processing logs.

Can I send Slack notifications when new action items are created from Gmail?

Yes, Slack notifications can be triggered when new action items are created from Gmail, allowing you to optionally issue alerts alongside writing markdown files and creating calendar events when due dates are present in the email.

How does Gmail automation handle duplicate emails during inbox triage?

Gmail automation handles duplicate emails during inbox triage by deduplicating processed messages and persisting logs under a Logs directory, ensuring the same unread important email is never classified or written as an action file twice.

Does Gmail action item automation work for a customer support inbox?

Yes, Gmail action item automation works for a customer support inbox by transforming unread important messages into a categorized Needs_Action queue, enabling faster response times through structured triage and priority classification.