Aller au contenu
TakoAPI
Retour aux skills

gmail-oauth

par kai-jar

DevOps & Cloud
3.2kTéléchargements rapportés par clawskills.sh
7Étoiles
2Vues
0 mention J'aimeConnecte-toi pour aimer ce skill
—Pas encore noté
Ta note

Résumé

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

Description

Ce que fait ce skill

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.

Quand l'utiliser

  • 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

Exemple de workflow

ENTRÉE

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

SORTIE

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

Prérequis

  • 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

Exécute la commande CLI, ou colle l'instruction dans Claude Code, Cursor, Codex ou l'agent de code que tu utilises.

Liens