gmail-watcher

Name: gmail-watcher
Availability: InStock
Author: misha-jatt

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

Updated Feb 22, 2026

Search Tags:#automation #logs #gmail #watcher #emails #needs_action #action-files

Ready to run

npx skills add https://github.com/misha-jatt/Personal-AI-Employee-Hackathon-0 --skill gmail-watcher

💬 Prompt for ChatGPT / Claude Chat▼

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.