From gws
Authenticate and manage credentials for the gws CLI — login, logout, status, scopes, service accounts, and credential storage.
How this skill is triggered — by the user, by Claude, or both
Slash command
/gws:gws-authThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
> **Note:** See the **gws-shared** skill for global flags and security rules.
Note: See the gws-shared skill for global flags and security rules.
Manage authentication and credentials for the gws CLI.
gws auth login # Interactive OAuth2 login (opens browser)
gws auth logout # Remove stored credentials
gws auth setup # Guided first-run setup wizard
gws auth status # Show current auth state and active scopes
gws auth export # Export credentials for use in other tools
gws auth login
Default scopes: Drive, Sheets, Gmail, Calendar, Docs, Slides, Tasks.
gws auth login --full
Adds pubsub and cloud-platform scopes. Requires a verified OAuth app or Workspace domain admin approval.
gws auth login --scopes drive,gmail,sheets,pubsub
Unrecognized service names are resolved dynamically from Discovery docs.
gws auth login --readonly
Grants only .readonly scopes for all services.
GOOGLE_WORKSPACE_CLI_TOKEN — Pre-obtained OAuth2 access token (highest priority)GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE — Path to OAuth credentials JSON~/.config/gws/GOOGLE_APPLICATION_CREDENTIALS — Standard Google ADC (fallback)export GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE=/path/to/service-account.json
gws drive files list
~/.config/gws/ (override with GOOGLE_WORKSPACE_CLI_CONFIG_DIR)export GOOGLE_WORKSPACE_CLI_KEYRING_BACKEND=file| Variable | Description |
|---|---|
GOOGLE_WORKSPACE_CLI_TOKEN | Pre-obtained OAuth2 access token |
GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE | Path to OAuth credentials JSON |
GOOGLE_WORKSPACE_CLI_CLIENT_ID | OAuth client ID |
GOOGLE_WORKSPACE_CLI_CLIENT_SECRET | OAuth client secret |
GOOGLE_WORKSPACE_CLI_CONFIG_DIR | Override config directory |
GOOGLE_WORKSPACE_CLI_KEYRING_BACKEND | keyring (default) or file |
GOOGLE_APPLICATION_CREDENTIALS | Standard Google ADC path |
gws auth setup # Guided wizard
gws auth status # Verify it worked
gws gmail +triage # Test with a read operation
gws auth status
gws auth login --scopes drive,gmail,sheets,calendar,pubsub,cloud-platform
gws auth login (minimal scopes) — add more later with --scopesgws auth status to verify permissions before running commandsGOOGLE_WORKSPACE_CLI_KEYRING_BACKEND=file and provide credentials via env varsgws auth exportnpx claudepluginhub fakoli/fakoli-plugins --plugin gwsGuides Google Workspace CLI (gws) setup: installs via npm, creates GCP project, configures OAuth and APIs (Gmail/Drive/etc.), authenticates, installs Claude Code skills. For first-time use or auth troubleshooting.
Provides gws CLI reference for authentication (OAuth, service accounts, multi-account), global flags (--format, --dry-run, --sanitize), output formatting, and method flags. Useful for Google Workspace API scripting.
Diagnoses and resolves Google Cloud authentication errors for gcloud, bq, dataform, and Python libraries. Verifies credentials and guides user through login.