Zum Inhalt springen
TakoAPI
Zurück zu den Skills

gmail-oauth

von kai-jar

DevOps & Cloud
3.2kDownloadzahlen laut clawskills.sh
7Sterne
2Aufrufe
0 LikesMelde dich an, um diesen Skill zu liken
—Noch nicht bewertet
Deine Bewertung

Kurzbeschreibung

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

Beschreibung

Was dieser Skill macht

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.

Wann du ihn einsetzt

  • 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

Beispiel-Workflow

EINGABE

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

AUSGABE

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

Voraussetzungen

  • 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

Führe den CLI-Befehl aus oder füge den Prompt in Claude Code, Cursor, Codex oder deinen Coding-Agenten ein.

Links