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

gmail-setup

Configure read-only Gmail access via a deployed Apps Script web app.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a one-time, guided setup to enable secure, read-only Gmail access via a Google Apps Script bridge so automated tools can list labels and read messages without manual OAuth flows for each invocation.

Core Features & Use Cases

  • One-time Apps Script deployment: Copy the repository Apps Script code into script.google.com, deploy as a web app, and authorize read-only Gmail access.
  • Secure key-based verification: Generate a random API key, embed it in the deployed script, and store the URL and key locally for authenticated reads.
  • Seamless verification via CDP: Uses a Chrome debug instance and provided Python tools to verify access by listing Gmail labels, useful when initial Gmail auth fails or during first-time setup.

Quick Start

Run the gmail-setup skill and provide your deployed Apps Script web app URL and generated API key so it saves credentials and verifies Gmail label access.

Frequently Asked Questions about gmail-setup

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

FAQPage Schema
How do I enable read-only Gmail access for automated tools without manual OAuth?▼

To enable read-only Gmail access without manual OAuth, deploy a Google Apps Script web app to act as a secure bridge, authorize it once, and use a generated API key for subsequent automated label and message retrieval.

What is the best way to fix Gmail authentication failures during automated setup?▼

The best way to fix Gmail authentication failures is to run the gmail-setup process, which uses a Chrome debug CDP verifier to re-authenticate and confirm access by successfully listing your Gmail labels.

Do I need a Chrome debug instance to verify Gmail label listing?▼

Yes, you need a local Chrome debug CDP verifier to run the provided Python tools, which securely save your credentials and confirm that automated Gmail label retrieval is functioning correctly.

How do I set up Google Apps Script for secure email access?▼

To set up Google Apps Script for secure email access, copy the repository code into script.google.com, deploy it as a web app, embed a random API key, and authorize read-only Gmail permissions.

Can I use an API key instead of OAuth to read Gmail messages?▼

Yes, you can generate a random API key, embed it in your deployed Google Apps Script web app, and store it locally to perform authenticated, read-only Gmail message retrieval without per-invocation OAuth.

Related Skills

Explore More Software Engineering Skills→
al-steval-stev

gcalendar-setup

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

Community
Intermediate
mgkyawzayyamgkyawzayya
1

add-gmail

Integrate Gmail MCP workflows to read and send emails in NanoClaw.

Community
Advanced
al-steval-stev

gmail

Search and retrieve Gmail messages and threads via JSON output.

Community
Intermediate
neverinfamousneverinfamous
19

auth-identity

Configure OAuth2, JWT, sessions, and RBAC for web and API services.

Community
Advanced