skillfed

gws-setup

gws-setup walks you through installing the Google Workspace CLI (@googleworkspace/cli) and configuring OAuth access to Google Workspace APIs. The skill covers GCP project creation, enabling Gmail, Drive, Calendar, Sheets, Docs, Chat, Tasks, and other APIs, then installs 90+ agent skills globally for Claude Code use.

gws-setup guides you through installing the Google Workspace CLI with OAuth credentials and 90+ agent skills for Claude Code.

AI-generated summary based on this skill's SKILL.md

943 95 MIT updated by jezweb

Install

jezweb/claude-skills/gws-setup · repository language: Python

CLI (skillfed)coming soon
git clone https://github.com/jezweb/claude-skills
cp -r claude-skills/plugins/integrations/skills/gws-setup ~/.claude/skills/gws-setup

Frequently asked questions

AI-generated answers based on this skill's SKILL.md and metadata

How do I set up Google Workspace CLI from scratch?

gws-setup guides you through installing the Google Workspace CLI (@googleworkspace/cli) and configuring OAuth access to Google Workspace APIs. Start by creating a GCP project, enabling the required APIs (Gmail, Drive, Calendar, Sheets, Docs, Chat, Tasks, and others), then generate OAuth credentials. gws-setup handles credential configuration and installs 90+ agent skills globally for Claude Code use.

What is involved in configuring GCP project and enabling Google Workspace APIs?

gws-setup covers creating a new GCP project, enabling Google Workspace APIs including Gmail, Drive, Calendar, Sheets, Docs, Chat, and Tasks. The skill walks you through the Google Cloud Console, helps you set up OAuth consent screens, and generates the credentials needed for CLI authentication.

How do I install and authenticate gws for use with Claude Code?

gws-setup installs the Google Workspace CLI globally and configures OAuth authentication. After setting up your GCP project and enabling APIs, gws-setup generates OAuth credentials, stores them securely, and deploys 90+ agent skills globally so Claude Code can access Google Workspace services.

How do I troubleshoot gws CLI authentication errors?

gws-setup includes troubleshooting guidance for common authentication issues. Check that your OAuth credentials are correctly configured, verify API scopes are enabled in your GCP project, and ensure the credentials file is in the expected location. gws-setup provides diagnostic steps and error resolution paths.

Can gws-setup deploy Google Workspace agent skills globally?

Yes. gws-setup installs 90+ Google Workspace agent skills globally after authentication is complete. These skills integrate with Claude Code and provide access to Gmail, Drive, Calendar, Sheets, Docs, Chat, Tasks, and other Google Workspace services across your environment.

What license does gws-setup use?

gws-setup is released under the MIT license, allowing free use, modification, and distribution with minimal restrictions.

SKILL.md

rendered from the published skill — quoted content, verbatim

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).

(truncated - see the full file via the links below)

Read as markdown · JSON record · Browse the source repository

File tree — 1 file
plugins/integrations/skills/gws-setup/SKILL.md

Related skills

Tags

oauth-setup gcp-project-config cli-installation workspace-api-enablement credential-management agent-skill-deployment authentication-flow scope-configuration multi-machine-setup