gmail

Classify Gmail messages into folders and draft responses for approval.

1|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/antonyfmunoz/OS --skill gmail-antonyfmunoz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gmail
Source: https://github.com/antonyfmunoz/OS/tree/main/skills/tools/gmail
Command: npx skills add https://github.com/antonyfmunoz/OS --skill gmail-antonyfmunoz

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill solves the problem of operationally managing an agent’s email inbox by routing incoming messages into the right workflow buckets and producing safe, founder-approved drafts instead of leaving the inbox unmanaged.

Core Features & Use Cases

  • EmailGPS classification (7-folder GPS): Classifies emails into ANTONY, TO_RESPOND, REVIEW, RESPONDED, WAITING_ON, RECEIPTS, and NEWSLETTERS using hard rules (e.g., financial keywords), noise detection, and AI-assisted classification for ambiguous cases.
  • Draft-first response workflow: Drafts responses using the DEX persona template so the founder reviews/approves before anything is sent.
  • Label management and Gmail operations: Lists, retrieves, sends drafts/messages, applies labels, and supports incremental sync patterns using Gmail search and history concepts.
  • GWS CLI integration for auth & execution: Uses the Google Workspace CLI (@googleworkspace/cli via npx) as the primary integration path to manage OAuth/token state via system keyring.

Use cases: daily inbox triage for a founder, extracting financial signals into RECEIPTS, drafting replies for TO_RESPOND, and surfacing only what needs direct attention in ANTONY.

Quick Start

Ask the AI to classify the founder’s unread emails using EmailGPS and draft any required responses for approval via Gmail.

Frequently Asked Questions about gmail

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

FAQPage Schema
How do I automate Gmail inbox triage and classify unread emails automatically?

Gmail inbox triage is automated using the EmailGPS classification system, which routes unread messages into seven distinct folders like TO_RESPOND, RECEIPTS, and NEWSLETTERS using hard keyword rules and AI-assisted detection for ambiguous cases.

Can I draft Gmail responses automatically without sending them directly?

Yes, you can draft Gmail responses automatically using a draft-first workflow that applies the DEX persona template. The system generates draft replies that require explicit founder approval before any message is sent through the Gmail API.

How do I apply Gmail labels to incoming messages using the Gmail API?

You apply Gmail labels by executing label management operations through the Google Workspace CLI wrapper, which lists, retrieves, and applies labels to parsed JSON message results. This supports incremental sync patterns using Gmail search and history concepts.

Do I need OAuth scopes to read and classify emails with the Gmail API?

Yes, OAuth scopes are required for Gmail v1 API access to read and classify emails. The Skill executes Gmail operations through the Google Workspace CLI, which manages OAuth token state via the system keyring.

What is the best way to detect financial newsletters in a Gmail inbox?

The best way to detect financial newsletters in a Gmail inbox is using hard keyword rules within the EmailGPS classification system. These rules automatically route matching messages into the NEWSLETTERS or RECEIPTS folders during the triage process.