skills.rest
al-stev
al-stevCOMMUNITY
Explore all skills by this author →
GitHub

gmail

Search and retrieve Gmail messages and threads via JSON output.

1|Updated Apr 7, 2026
Search Tags:#search#email#threads#gmail#labels#apps-script#okta
One-click install
npx skills add https://github.com/al-stev/field-eng-skills --skill gmail-al-stev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gmail
Source: https://github.com/al-stev/field-eng-skills/tree/main/.claude/skills/gmail
Command: npx skills add https://github.com/al-stev/field-eng-skills --skill gmail-al-stev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Provides fast, read-only access to Gmail so you can quickly locate, read, and gather context from email messages and conversations without manual inbox browsing.

Core Features & Use Cases

  • Search messages using Gmail query operators (from:, subject:, is:unread, newer_than:, has:attachment).
  • Read messages and threads with selectable formats (minimal, metadata, full) and follow pagination via nextStart/start.
  • List and inspect labels and use programmatic JSON output for integration with triage, escalation, or support workflows.
  • Use Case: Find recent escalation emails from a customer, fetch the full conversation thread, and summarize relevant action items.

Quick Start

Ask the gmail skill to search for unread messages from [email protected] and return the full message bodies in JSON.

Frequently Asked Questions about gmail

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

FAQPage Schema
How do I search and retrieve Gmail messages using query operators?▼

To search Gmail messages, you use standard query operators like from:, subject:, is:unread, newer_than:, and has:attachment. The skill retrieves matching messages and returns them in JSON format for read-only investigation and triage.

Can I read full email thread content and paginate through large results?▼

Yes, you can read full email thread content with selectable formats (minimal, metadata, full) and paginate through large search results using the nextStart and start parameters to navigate sequentially.

What do I need to configure to access Gmail through a Google Apps Script web app?▼

You need a configured Google Apps Script web app URL and API key, plus a Chrome debug instance for CDP-based Okta SSO authentication. These enable the Python tools to fetch and return JSON-formatted Gmail data.

Does this Gmail search approach work for customer support escalation workflows?▼

Yes, searching Gmail is designed for customer support escalation workflows. You can locate recent emails from a customer, fetch the full conversation thread, and gather context to summarize relevant action items.

Can I list and inspect Gmail labels programmatically for triage workflows?▼

Yes, you can list and inspect Gmail labels programmatically. The skill returns label data in JSON format, allowing integration with automated triage, escalation, or support workflow systems.

Why does Gmail retrieval require a Chrome debug instance for Okta SSO?▼

A Chrome debug instance is required for CDP-based Okta SSO to handle single sign-on authentication programmatically. This allows the Python tools to authenticate and access the configured Google Apps Script web app securely.

Related Skills

Explore More Content & Communication Skills→
al-steval-stev

gcalendar-setup

Provision Google Apps Script endpoints to expose calendar data to local tools.

Community
Intermediate
vikingokftvikingokft

recipe-forward-labeled-emails

Forward Gmail messages with a specified label to a designated address.

Official
Intermediate
zapierzapier
373

Work on Ticket

Automate Jira ticket updates from Zapier triggers with an auditable activity log.

Official
Advanced
zerwizzerwiz

agentmail

Create and manage an AI agent email inbox via AgentMail MCP.

Community
Intermediate