Gmail Operations
When to Use
Use for Gmail/himalaya setup and recurring inbox operations: triage, extraction to repositories, archive hygiene, attachment/document parsing, unsubscribe sweeps, and relationship touchbase.
Class-Level Workflow
- Confirm account context and OAuth/token health first.
- Use live Gmail/himalaya/API access as the source of truth. Do not treat cached Claude/Hermes tool-result files, old session transcripts, or browser history as evidence of current email state; those are only historical hints.
- If live email access is unavailable, fail closed: say email verification is blocked, name the missing access class, and convert the task into a concrete follow-up checklist rather than implying the inbox was checked.
- Classify mail by action class: triage, extract/archive, attachment processing, unsubscribe, contact/touchbase.
- Preserve source message identifiers in extracted artifacts.
- Keep destructive mail actions batched and reviewable.
Live-Access Pitfall: Coordination Reminders
For appointment/reminder coordination that asks to “check email,” first verify a real mail client/API path is authenticated. Browser Gmail redirects to login, stale MCP result files, or previous session snippets are not sufficient. If blocked, create/update the coordination artifact with explicit checklist items like “check email/portal/texts for confirmation,” and report the email check as blocked rather than silently substituting historical evidence. See references/live-email-source-of-truth.md.
Consolidated Session Learnings
The references/ directory contains archived narrow skills absorbed during the 2026-04-29 umbrella consolidation pass. Use the subsections below as the class-level index, then open the named reference when a case-specific recipe is needed.
Absorbed Narrow Skills (2026-04-29)
gmail-attachment-to-document
- Former skill demoted to
references/gmail-attachment-to-document.md.
- Preserved insight: Download attachments from Gmail threads, parse their content (Excel, PDF), extract structured data, and save to target repos with proper legal scanning.
gmail-data-extraction
- Former skill demoted to
references/gmail-data-extraction.md.
- Preserved insight: Extract structured data from Gmail emails using REST API (no pip dependencies). Covers inbox scanning, subject line regex extraction, email text parsing, thread-aware drafting, and legal-scan-before-commit workflow.
gmail-email-to-repo-extraction
- Former skill demoted to
references/gmail-email-to-repo-extraction.md.
- Preserved insight: Extract structured data from Gmail inbox emails, enrich with domain-specific classification, legal-scan against deny list, commit to appropriate repo, then optionally delete originals.
gmail-extract-and-clean
- Former skill demoted to
references/gmail-extract-and-clean.md.
- Preserved insight: Extract emails from Gmail to /mnt/ace//, archive to appropriate workspace-hub external repos, commit, then delete from inbox. Uses email-routing.yaml for sender→repo routing.
gmail-extract-archive
- Former skill demoted to
references/gmail-extract-archive.md.
- Preserved insight: Extract Gmail data into a structured archive repo, parse attachments, legal scan, then delete from inbox. Single source of truth for all email data across 3 accounts.
gmail-headless-oauth
- Former skill demoted to
references/gmail-headless-oauth.md.
- Preserved insight: Manual OAuth2 token exchange for Gmail on headless servers. Bypass gmail-mcp-multiauth browser requirement. Generate auth URLs, exchange codes, manage multi-account credentials with auto-refresh.
gmail-multi-account
- Former skill demoted to
references/gmail-multi-account.md.
- Preserved insight: Multi-account Gmail management via himalaya CLI. Three accounts (aceengineer, achantav, skestates) with distinct triage rules, contact DBs, and tone profiles. Foundation skill for email automation.
gmail-touchbase
- Former skill demoted to
references/gmail-touchbase.md.
- Preserved insight: Periodic relationship maintenance via email — identify contacts due for outreach, draft personalized check-ins, queue for user approval. Supports per-account tone and cadence.
gmail-triage
- Former skill demoted to
references/gmail-triage.md.
- Preserved insight: Daily multi-account Gmail inbox triage — scan unread, classify by urgency, cross-reference contacts, generate actionable digest. Supports ace/personal/skestates accounts.
gmail-unsubscribe
- Former skill demoted to
references/gmail-unsubscribe.md.
- Preserved insight: Identify and batch-unsubscribe from newsletters and marketing emails across Gmail accounts. Scans List-Unsubscribe headers, generates candidates, executes with user approval.
contact-manager
- Former skill demoted to
references/contact-manager.md.
- Preserved insight: Normalize, classify, and manage contact databases across 3 Gmail accounts. Clean CSV exports, deduplicate, tag categories, flag touchbase/unsubscribe candidates.
1---2name: gmail-operations-23description: Class-level Gmail and email operations: multi-account setup, OAuth, triage, extraction, archiving, attachments, unsubscribe, and touchbase workflows.4---56# Gmail Operations78## When to Use9Use for Gmail/himalaya setup and recurring inbox operations: triage, extraction to repositories, archive hygiene, attachment/document parsing, unsubscribe sweeps, and relationship touchbase.1011## Class-Level Workflow121. Confirm account context and OAuth/token health first.132. Use live Gmail/himalaya/API access as the source of truth. Do **not** treat cached Claude/Hermes tool-result files, old session transcripts, or browser history as evidence of current email state; those are only historical hints.143. If live email access is unavailable, fail closed: say email verification is blocked, name the missing access class, and convert the task into a concrete follow-up checklist rather than implying the inbox was checked.154. Classify mail by action class: triage, extract/archive, attachment processing, unsubscribe, contact/touchbase.165. Preserve source message identifiers in extracted artifacts.176. Keep destructive mail actions batched and reviewable.1819## Live-Access Pitfall: Coordination Reminders2021For appointment/reminder coordination that asks to “check email,” first verify a real mail client/API path is authenticated. Browser Gmail redirects to login, stale MCP result files, or previous session snippets are not sufficient. If blocked, create/update the coordination artifact with explicit checklist items like “check email/portal/texts for confirmation,” and report the email check as blocked rather than silently substituting historical evidence. See `references/live-email-source-of-truth.md`.2223## Consolidated Session Learnings2425The `references/` directory contains archived narrow skills absorbed during the 2026-04-29 umbrella consolidation pass. Use the subsections below as the class-level index, then open the named reference when a case-specific recipe is needed.26## Absorbed Narrow Skills (2026-04-29)2728### `gmail-attachment-to-document`2930- Former skill demoted to `references/gmail-attachment-to-document.md`.31- Preserved insight: Download attachments from Gmail threads, parse their content (Excel, PDF), extract structured data, and save to target repos with proper legal scanning.3233### `gmail-data-extraction`3435- Former skill demoted to `references/gmail-data-extraction.md`.36- Preserved insight: Extract structured data from Gmail emails using REST API (no pip dependencies). Covers inbox scanning, subject line regex extraction, email text parsing, thread-aware drafting, and legal-scan-before-commit workflow.3738### `gmail-email-to-repo-extraction`3940- Former skill demoted to `references/gmail-email-to-repo-extraction.md`.41- Preserved insight: Extract structured data from Gmail inbox emails, enrich with domain-specific classification, legal-scan against deny list, commit to appropriate repo, then optionally delete originals.4243### `gmail-extract-and-clean`4445- Former skill demoted to `references/gmail-extract-and-clean.md`.46- Preserved insight: Extract emails from Gmail to /mnt/ace/<repo>/, archive to appropriate workspace-hub external repos, commit, then delete from inbox. Uses email-routing.yaml for sender→repo routing.4748### `gmail-extract-archive`4950- Former skill demoted to `references/gmail-extract-archive.md`.51- Preserved insight: Extract Gmail data into a structured archive repo, parse attachments, legal scan, then delete from inbox. Single source of truth for all email data across 3 accounts.5253### `gmail-headless-oauth`5455- Former skill demoted to `references/gmail-headless-oauth.md`.56- Preserved insight: Manual OAuth2 token exchange for Gmail on headless servers. Bypass gmail-mcp-multiauth browser requirement. Generate auth URLs, exchange codes, manage multi-account credentials with auto-refresh.5758### `gmail-multi-account`5960- Former skill demoted to `references/gmail-multi-account.md`.61- Preserved insight: Multi-account Gmail management via himalaya CLI. Three accounts (aceengineer, achantav, skestates) with distinct triage rules, contact DBs, and tone profiles. Foundation skill for email automation.6263### `gmail-touchbase`6465- Former skill demoted to `references/gmail-touchbase.md`.66- Preserved insight: Periodic relationship maintenance via email — identify contacts due for outreach, draft personalized check-ins, queue for user approval. Supports per-account tone and cadence.6768### `gmail-triage`6970- Former skill demoted to `references/gmail-triage.md`.71- Preserved insight: Daily multi-account Gmail inbox triage — scan unread, classify by urgency, cross-reference contacts, generate actionable digest. Supports ace/personal/skestates accounts.7273### `gmail-unsubscribe`7475- Former skill demoted to `references/gmail-unsubscribe.md`.76- Preserved insight: Identify and batch-unsubscribe from newsletters and marketing emails across Gmail accounts. Scans List-Unsubscribe headers, generates candidates, executes with user approval.7778### `contact-manager`7980- Former skill demoted to `references/contact-manager.md`.81- Preserved insight: Normalize, classify, and manage contact databases across 3 Gmail accounts. Clean CSV exports, deduplicate, tag categories, flag touchbase/unsubscribe candidates.
vamseeachanta