Skip to content
TakoAPI
Back to skills

gmail-oauth

by kai-jar

DevOps & Cloud
3.2kDownloads reported by clawskills.sh
7Stars
2Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Set up Gmail API access via gog CLI with manual OAuth flow.

Description

What This Skill Does

Sets up Gmail API access using the `gog` CLI with a headless-compatible OAuth flow. Handles credential configuration, token exchange, and common authentication errors for personal or server-side Gmail integrations.

The `gog` CLI with file-based keyring makes OAuth token management work on headless servers where browser-based flows are impractical.

When to Use It

  • Authorizing Gmail access on a headless server
  • Renewing expired OAuth tokens without a browser on the server
  • Setting up Gmail API for a personal automation script
  • Troubleshooting OAuth errors like invalid_grant or redirect_uri_mismatch
  • Configuring Gmail integration for a self-hosted email tool

Example Workflow

INPUT

User asks: set up Gmail OAuth on my headless server

AGENT
  1. 1

    Install gog CLI via brew and create a Google Cloud project with Gmail API enabled

  2. 2

    Download OAuth client secret JSON (Desktop app type) from Google Cloud Console

  3. 3

    Run gog auth credentials with the JSON file and configure file-based keyring

  4. 4

    Generate the OAuth URL, open it in a desktop browser, approve permissions, and copy the auth code

  5. 5

    Exchange the code immediately using the auth script and verify access with a test search

OUTPUT

Gmail API access configured with a permanent refresh token stored in file-based keyring

Requirements

  • Google Cloud project with Gmail API enabled
  • OAuth 2.0 client credentials JSON file (Desktop app type) from Google Cloud Console
  • gog CLI (`brew install steipete/tap/gogcli`)
  • GOG_KEYRING_PASSWORD environment variable

Installation

clawhub install kai-jar/gmail-oauth

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links