gcp-login

Authenticate to Google Cloud Platform using Application Default Credentials. Use when user selects GCP from cloud provider selection, or says "login to GCP", "gcloud auth", "authenticate to Google Cloud".

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026

When & Why to Use This Skill

This Claude skill streamlines the Google Cloud Platform (GCP) authentication process by automating the configuration of Application Default Credentials (ADC). It solves the friction of manual CLI logins by providing a guided, agent-led workflow to execute 'gcloud auth' commands, ensuring the AI agent has the necessary permissions to manage cloud resources and services seamlessly.

Use Cases

  • Cloud Resource Management: Quickly authenticate Claude to your GCP environment to allow the agent to manage Compute Engine instances, Cloud Storage buckets, or BigQuery datasets.
  • DevOps Automation: Use as a foundational step in complex SRE workflows where the agent needs to execute authenticated gcloud CLI commands for infrastructure deployment or troubleshooting.
  • Credential Refreshing: Seamlessly update or re-authenticate Application Default Credentials (ADC) when tokens expire during long-running development or data processing sessions.
namegcp-login
descriptionAuthenticate to Google Cloud Platform using Application Default Credentials. Use when user selects GCP from cloud provider selection, or says "login to GCP", "gcloud auth", "authenticate to Google Cloud".
allowed-toolsBash, Read, AskUserQuestion

GCP Login Skill

Authenticate to Google Cloud Platform using gcloud auth login --update-adc.

Activation Triggers

  • /auth-gcp slash command
  • User says: "login to GCP", "gcloud auth", "authenticate to GCP"

Prerequisites

  • gcloud CLI installed and in PATH
  • Environment variables in .env (optional):
    • GOOGLE_CLOUD_PROJECT - GCP project ID for quota project
    • GCLOUD_EMAIL_ADDRESS - Email for bucket policy bindings

Usage

Human CLI

# Authenticate to GCP
./scripts/gcp-auth.ps1

# Force re-authentication
./scripts/gcp-auth.ps1 -Force

Claude Agent

# Via skill invocation
uv run --directory ${CLAUDE_PATH} python -m claude_apps.skills.gcp_login [--force]

Auth URL Detection

The skill captures and displays the authentication URL:

Field Value
URL https://accounts.google.com/o/oauth2/auth?...

Workflow

  1. Check if already authenticated (skip if valid, unless --force)
  2. Set project from GOOGLE_CLOUD_PROJECT env var if available
  3. Run gcloud auth login --update-adc --no-launch-browser
  4. Display auth URL for user to open in browser
  5. Verify authentication success

Code Structure

apps/src/claude_apps/skills/gcp_login/
├── __init__.py
├── __main__.py    # Entry point
└── auth.py        # GCloud auth with URL detection