Google Workspace CLI — Security & Safety

This skill provides expert guidance and automation for Google Workspace administration using the open-source gws CLI. It covers installation, authentication, and workflows for Gmail, Drive, Sheets, Calendar, and security audits, along with local Python tools for diagnostics, recipe templates, and output analysis.

engineering claude-code

📂 View skill on GitHub ↗ 🚀 How to use

✨ What it does

Provides installation instructions via npm, Homebrew, Cargo, or pre-built binaries.
Guides OAuth and service-account authentication with environment variable support.
Includes workflows for Gmail, Drive & Sheets, Calendar, and security audits.
Offers Python tools: gws_doctor, auth_setup_guide, gws_recipe_runner, workspace_audit, and output_analyzer.
Emphasizes verifying command syntax with gws --help and schema commands before scripting.
Supports bulk operations with --page-all and --dry-run for safety.

🎯 When to use it

When you need to automate Gmail operations like sending, searching, or managing labels.
When managing Drive files, Sheets data, or Calendar events programmatically.
When performing security audits on Google Workspace configuration.
When setting up or troubleshooting the gws CLI and its authentication.

🚀 How to use

Trigger by asking for help with Google Workspace administration using the gws CLI, such as 'Set up gws CLI' or 'Automate sending emails with gws'. The skill expects you to have or be willing to install the gws CLI and provide the necessary Google Cloud credentials. Use the provided commands and Python scripts as templates, but always verify exact command syntax with gws --help or gws schema. Example prompts:

Help me install and authenticate the gws CLI for Gmail automation.
Show me how to list Drive files and create a Google Sheet using gws.

📄 Output: The skill produces command examples, Python script usage, and guidance for automating Google Workspace tasks, but does not generate a single deliverable file.

📦 Add this skill to Claude Code

# 1. Get the skills repo
git clone --depth 1 https://github.com/alirezarezvani/claude-skills /tmp/claude-skills

# 2. Copy this skill into your project (or ~/.claude/skills for all projects)
mkdir -p .claude/skills
cp -r /tmp/claude-skills/engineering-team/google-workspace-cli/skills/google-workspace-cli .claude/skills/google-workspace-cli

Skill source: engineering-team/google-workspace-cli/skills/google-workspace-cli/SKILL.md

⚠️ Good to know

The gws CLI is pre-v1.0 and its command surface is dynamically generated, so commands must be verified against the installed version; OAuth tokens expire after 1 hour and API rate limits may affect bulk operations.

❓ FAQ

How do I install the gws CLI?

You can install it via npm (requires Node.js 18+), Homebrew on macOS/Linux, Cargo from source, or pre-built binaries from the releases page.

What authentication methods are supported?

The skill supports interactive OAuth setup and headless/CI service-account authentication, with environment variables for client ID, secret, credentials file, and token.

How can I run a security audit?

Run the workspace_audit.py script with options like --json, --services, or --demo to audit security configuration across Gmail, Drive, Calendar, and other services.

🤖 Overview, features, install steps and FAQ were generated from the project's SKILL.md on Sep 4, 2026. Always check the original source before running commands.