Gws Setup

This walks you through the full OAuth setup for Google Workspace CLI, from creating a GCP project to installing 90+ agent skills for Gmail, Drive, Calendar, Sheets, and the rest. The guide is thorough on the annoying bits: configuring the Chat API app (required even for user context), handling the too-long OAuth URL that breaks in terminals, and dealing with Testing vs Production app status. Use this for first-time gws setup or when auth is broken. The workflow assumes you're starting from scratch and checks what's already done so you can skip ahead. Once complete, you get an authenticated CLI and all the gws skills loaded into Claude Code.

skills.sh installs: 1.1K
GitHub stars: 1.1K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add jezweb/claude-skills --skill gws-setup --agent claude-code

Installs into .claude/skills of the current project.

Files

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:

# 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

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

SKILL.md on GitHub

Details

Repository: github.com/jezweb/claude-skills
Categories: Backend & APIs, Security, AI & Agent Building, Debugging, Cloud & Infrastructure, CLI & Terminal, Office & Documents
First seen: May 16, 2026