gws-setup
Set up the Google Workspace CLI (gws) from scratch. Guides through GCP project creation, OAuth credentials, authentication, and installing 90+ agent skills for Claude Code. Use whenever the user wants to set up gws for the first time, configure Google Workspace API access, install the Google Workspace CLI, or troubleshoot gws auth issues.
npx skills add jezweb/claude-skills --skill gws-setup --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Google Workspace CLI — First-Time Setup Set up the `gws` CLI (@googleworkspace/cli) with OAuth credentials and 90+ agent skills for Claude Code. Produces a fully authenticated CLI with skills for Gmail, Drive, Calendar, Sheets, Docs, Chat, Tasks, and more. ## Prerequisites - Node.js 18+ - A Google account (personal or Workspace) - Access to Google Cloud Console (console.cloud.google.com) ## Workflow ### Step 1: Pre-flight Checks Check what's already done and skip completed steps: ```bash # Check if gws is installed which gws && gws --version # Check if client_secret.json exists ls ~/.config/gws/client_secret.json # Check if already authenticated gws auth status ``` If `gws auth status` shows `"status": "success"` with scopes, skip to Step 6 (Install Skills). ### Step 2: Install the CLI ```bash npm install -g @googleworkspace/cli gws --version ``` ### Step 3: Create a GCP Project and OAuth Credentials The user needs to create OAuth Desktop App credentials in Google Cloud Console. Walk them through each step. **3a. Create or select a GCP project:** Direct the user to: `https://console.cloud.google.com/projectcreate` Or use an existing project. Ask the user which they prefer. **3b.
- Prerequisites
- Workflow
- Step 1: Pre-flight Checks
- Step 2: Install the CLI
- Step 3: Create a GCP Project and OAuth Credentials
- Step 4: Choose Scopes
- Step 5: Authenticate
- Step 6: Install Agent Skills
- Step 7: Save Credentials for Other Machines
- Step 8: Verify Everything Works
- Critical Patterns
- Testing vs Production OAuth Apps
- Scope Reference
- Environment Variable Alternative
Check if gws is installed which gws && gws --version Check if client_secret.json exists ls ~/.config/gws/client_secret.json Check if already authenticated gws auth status npm install -g @googleworkspace/cli gws --version mkdir -p ~/.config/gws gws auth login --full 2>&1 | tee /tmp/gws-auth-output.txt
What does the gws-setup skill do?
Set up the Google Workspace CLI (gws) from scratch. Guides through GCP project creation, OAuth credentials, authentication, and installing 90+ agent skills for Claude Code. Use whenever the user wants to set up gws for the first time, configure Google Workspace API access, install the Google Workspace CLI, or troubleshoot gws auth issues.
How do I install it?
Run `npx skills add jezweb/claude-skills --skill gws-setup --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From jezweb/claude-skills, a repository with 954 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.