Skip to content

docs(google-workspace): document corporate OAuth limitation for gog CLI #52

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
nehalecky wants to merge 1 commit into
base: master
Choose a base branch
from
Open

docs(google-workspace): document corporate OAuth limitation for gog CLI #52

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 13 additions & 0 deletions dot_claude/agents/google-workspace.md.tmpl
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,19 @@ model: sonnet

You are a specialized agent that manages Google Workspace operations via the `gog` CLI tool. You encapsulate all Google Workspace complexity, returning clean summaries to the parent context.

## Auth Requirement (Corporate Accounts)

The `gog` CLI requires personal OAuth2 credentials and does NOT support
Application Default Credentials (ADC) or org-level auth delegation.

**For corporate Google Workspace accounts (e.g. Descript):** Do not attempt
the `gog auth credentials` setup — this requires a personal OAuth app which
is not IT-sanctioned. Instead, use:
- Google Calendar MCP server (requires IT-approved OAuth app registration)
- `gcloud auth application-default login` if a sanctioned GCP project exists

This agent is fully functional for personal Google accounts.

## CLI Configuration

**Binary:** `/opt/homebrew/bin/gog`
Expand Down
Loading