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
Decision gist · record as of 2026-07-02
gws-setup guides you through installing the Google Workspace CLI with OAuth credentials and 90+ agent skills for Claude Code. 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.
Use it when
- gws-setup covers creating a new GCP project, enabling Google Workspace APIs including Gmail, Drive, Calendar, Sheets, Docs, Chat, and Tasks.
- gws-setup installs the Google Workspace CLI globally and configures OAuth authentication.
Verify before relying
Read SKILL.md below before installing (1 file). Open directory: indexed for reading, not audited.
Install
jezweb/claude-skills/gws-setup · repository language: Python
Open directory. Skills are indexed for reading, not audited. Review a skill's body before installing it.
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)
File tree — 1 file
plugins/integrations/skills/gws-setup/SKILL.md
Let your AI agent find skills like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 56,283 agent skills by what they can do, searchable in plain language.
wish › “Set up Google Workspace CLI with OAuth credentials from scratch”
Give your agent the search over MCP, or paste the wish link into any chat. No install? Search from any chat →
Related skills
A single command-line interface that connects to every Google Workspace API, from Drive and Gmail to Calendar, Sheets, Docs, Slides, Chat, and Admin tools. The CLI dynamically discovers available endpoints at runtime, so new Google APIs are supported automatically without updates. Built for both human operators and AI agents with JSON-structured output.
Google Workspace brings Gmail, Calendar, Drive, Sheets, and Docs into your agent through a Python wrapper around Google's official gws CLI. Setup handles OAuth2 authorization once, then token refresh happens automatically. Search emails, manage events, query files, read spreadsheets, and access contacts—all via a unified command interface.
Google Workspace integrates Gmail, Calendar, Drive, Contacts, Sheets, and Docs into Hermes through managed OAuth2 authentication. The skill leverages the Google Workspace CLI for extended API coverage when installed, otherwise falling back to Python client libraries for core functionality.
Google Workspace skill brings Gmail, Calendar, Drive, Sheets, and Docs into your agent workflows using OAuth2 and a Python-backed CLI. It supports both the bundled client and the optional gws CLI for extended coverage, with flexible service scoping during setup.
This skill signs a Google account into its own gws config directory and registers it with a tag, enabling the multi-account model where one OAuth client authorizes many accounts. It runs the OAuth login flow in your default browser, confirms the session, and registers the account locally. Typically invoked by google-workspace-setup rather than directly.
Gws is a command-line interface for Google Workspace that streamlines email triage, calendar management, file uploads, spreadsheet operations, and task creation. It supports helper commands for common workflows like standup reports and meeting prep, plus raw API access for advanced use cases. Built for both interactive queries and scripted automation.
More skills gws (MIT)