gws-setup

1# Google Workspace CLI — First-Time Setup
2 
3Set 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.
4 
5## Prerequisites
6 
7- Node.js 18+
8- A Google account (personal or Workspace)
9- Access to Google Cloud Console (console.cloud.google.com)
10 
11## Workflow
12 
13### Step 1: Pre-flight Checks
14 
15Check what's already done and skip completed steps:
16 
17```bash
18# Check if gws is installed
19which gws && gws --version
20 
21# Check if client_secret.json exists
22ls ~/.config/gws/client_secret.json
23 
24# Check if already authenticated
25gws auth status
26```
27 
28If `gws auth status` shows `"status": "success"` with scopes, skip to Step 6 (Install Skills).
29 
30### Step 2: Install the CLI
31 
32```bash
33npm install -g @googleworkspace/cli
34gws --version
35```
36 
37### Step 3: Create a GCP Project and OAuth Credentials
38 
39The user needs to create OAuth Desktop App credentials in Google Cloud Console. Walk them through each step.
40 
41**3a. Create or select a GCP project:**
42 
43Direct the user to: `https://console.cloud.google.com/projectcreate`
44 
45Or use an existing project. Ask the user which they prefer.
46 
47**3b. Enable Google Workspace APIs:**
48 
49Direct the user to the API Library for their project: `https://console.cloud.google.com/apis/library?project=PROJECT_ID`
50 
51Enable these APIs (search for each):
52- Gmail API
53- Google Drive API
54- Google Calendar API
55- Google Sheets API
56…