What problem does it solve?
Manually checking Gmail for important messages is constant context-switching, and naive inbox watchers waste tokens on empty polls. This Skill monitors one or more Gmail accounts on a cron schedule and only wakes the assistant when new mail actually arrives, applying your standing instruction (urgent-only pings, newsletter digests, invoice forwarding) automatically.
Core Features & Use Cases
- Token-efficient polling: A deterministic TypeScript script syncs via the Gmail History API; empty polls spend zero LLM tokens and only new messages trigger an assistant turn.
- Multi-account monitoring: Watch several Google OAuth connections with one schedule, each with independent per-mailbox state, watermark tracking, and failure isolation in SQLite.
- At-most-once delivery: Watermarks and a reported-message ledger commit before escalation, so retries never deliver duplicate digests, and expired history IDs trigger automatic re-baselining.
- Use Case: Tell the assistant "watch my work and personal Gmail, ping me only about emails needing a reply" — it creates a 15-minute script-mode schedule that summarizes new mail and flags anything urgent.
Quick Start
Ask the assistant to set up Gmail Triggers to watch your inbox and notify you only when urgent email arrives.