skills.rest
jezweb
jezwebCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

gws-install

Installs and authenticates the Google Workspace CLI on additional machines using existing OAuth credentials.

989|102|Updated Oct 20, 2025
Search Tags:#Authentication#Gmail#Google Workspace#install#cli setup#gws CLI#oAuth
One-click install
npx skills add https://github.com/jezweb/claude-skills --skill gws-install
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gws-install
Source: https://github.com/jezweb/claude-skills/tree/main/plugins/integrations/skills/gws-install
Command: npx skills add https://github.com/jezweb/claude-skills --skill gws-install

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @googleworkspace/cli.

What problem does it solve?

Setting up the Google Workspace CLI (gws) on a second machine or after a fresh OS install normally means repeating the entire Google Cloud project configuration. This Skill streamlines reinstallation by reusing the client_secret.json from a previous gws-setup, getting an authenticated CLI running quickly.

Core Features & Use Cases

  • Credential Reuse: Accepts client_secret.json via pasted JSON, local file copy, or environment variables instead of requiring a new GCP project.
  • Guided OAuth Flow: Handles the long multi-scope OAuth URL by extracting it to a file and opening it programmatically so it does not break in the terminal.
  • Agent Skill Installation: Runs npx skills add to install 90+ Google Workspace skills into Claude Code, plus verification and troubleshooting steps.
  • Use Case: You get a new laptop and want gws working with Gmail, Calendar, and Drive. Provide your existing client_secret.json and the Skill walks through install, authentication, and skill setup.

Quick Start

Install gws on this machine using my existing client_secret.json credentials and authenticate my Google account.

Frequently Asked Questions about gws-install

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I install gws on a new machine?▼

Install the CLI globally with npm install -g @googleworkspace/cli, place your existing client_secret.json in ~/.config/gws/, then run gws auth login with your desired scopes and approve the OAuth flow in your browser.

Do I need to create a new Google Cloud project for a second computer?▼

No. You can reuse the client_secret.json from your original gws-setup on any additional machine. Only use the full gws-setup flow if you have lost the credentials file.

Why does the gws OAuth URL break when copied from the terminal?▼

The OAuth URL contains 30+ scopes and wraps across terminal lines, corrupting it when copied. Extract it to a file with grep and open it programmatically, or read the URL from the saved file.

Why does my gws token expire after 7 days?▼

Tokens expire weekly when the Google Cloud OAuth consent screen is in Testing status. Re-run gws auth login to refresh, or publish the app to Production in the GCP Console for permanent tokens.

Why are gws skills not appearing in Claude Code after install?▼

Skills load only at session start, so restart Claude Code after running npx skills add. Verify installation by listing ~/.claude/skills/gws-* directories, which should show 30 or more entries.

Related Skills

Explore More Software Engineering Skills→
m13vm13v
312

gws-setup

Automate Google Cloud OAuth app creation and configuration for the GWS CLI.

Community
Advanced
RobbyMo81RobbyMo81

gog

Automate Google Workspace administration for Gmail, Calendar, Drive, Contacts, Sheets, and Docs via CLI.

Community
Intermediate
anthropicsanthropics
23.8k

setup-zoom-oauth

Configure Zoom OAuth grants, scopes, and token refresh for app integrations.

Official
Intermediate
tapanshahtapanshah

gdocs-setup

Configure Google Cloud project, APIs, and OAuth credentials for Google Docs integration.

Community
Intermediate