Agent skill

Google Workspace CLI

by hoodini in hoodini/ai-agents-skills

Interact with all Google Workspace APIs via the gws CLI. An agent skill from hoodini/ai-agents-skills.

No licenceAuto-check: notesDocuments & Office

Install Google Workspace CLI

skills CLI
$ npx skills add hoodini/ai-agents-skills --skill google-workspace-cli -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install hoodini/ai-agents-skills google-workspace-cli --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/hoodini/ai-agents-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/google-workspace-cli .claude/skills/google-workspace-cli && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
google-workspace-cli
GitHub stars
282
Token cost
~10k tokens
SKILL.md length
1,983 words
Files
1
Skills in repo
30
Repo updated
First seen
Licence
None found

At a glance

Interact with all Google Workspace APIs via the gws CLI. An agent skill from hoodini/ai-agents-skills.

  • Works in 5 steps: Open Google Cloud Console in the target… → Configure OAuth branding/audience if… → Add your account under Test users → …
  • Managing Drive files
  • SKILL.md covers How It Works, Prerequisites, Installation and Quick Start, plus 3 more sections
  • Calls npx, jq and npm; reaches github.com and console.cloud.google.com; needs GOOGLE_WORKSPACE_CLI_TOKEN

What it does

Google Workspace CLI is an agent skill from hoodini/ai-agents-skills. Interact with all Google Workspace APIs via the gws CLI. Use when managing Drive files, sending/reading Gmail, creating Calendar events, reading/writing Sheets/Docs/Slides, managing Chat spaces, contacts, Admin users/groups, Vault eDiscovery, Classroom, Apps Script, Workspace Events, or configuring the gws MCP server. Triggers on Google Workspace, gws, Drive, Gmail, Calendar, Sheets, Docs, Slides, Chat, Tasks, Meet, Forms, Keep, Admin, People, Vault, Classroom, Apps Script, Cloud Identity, Alert Center, Groups…

Its SKILL.md is about 10k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Documents & Office, covering Cloud office suites and Email management. It works with Google Workspace, Model Context Protocol, Gmail and Google Cloud. The repository describes itself as: 🧠 AI Agent Skills Repository - A curated collection of specialized skills for AI coding agents (Claude Code, GitHub Copilot, Cursor, Windsurf). Created by Yuval Avidani using…

When your agent uses it

  • Managing Drive files
  • Sending/reading Gmail
  • Creating Calendar events
  • Reading/writing Sheets/Docs/Slides

Example prompts

  • “/google-workspace-cli”

Requirements

  • Node.js
  • A credential in GOOGLE_WORKSPACE_CLI_TOKEN

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Open Google Cloud Console in the target project
  2. Configure OAuth branding/audience if prompted — App type: External (testing mode is fine)
  3. Add your account under Test users
  4. Create an OAuth client — Type: Desktop app
  5. Download the client JSON → save to ~/.config/gws/client_secret.json

What it can do on your machine

Read from SKILL.md and the folder at commit f7a43d8. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npx
    • jq
    • npm
    • cargo
    • nix
    • gcloud
    • gemini

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • github.com
    • console.cloud.google.com
    • console.developers.google.com

    Also links to:

    • developers.google.com
    • cloud.google.com
    • modelcontextprotocol.io
    • npmjs.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • GOOGLE_WORKSPACE_CLI_TOKEN

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Google Workspace CLI loads about 10k tokens when it runs. Until then it costs about 162 tokens; SKILL.md has 1,983 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~162
When it runs · the whole SKILL.md, loaded when a task matches
~10k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:167
    nvironment variables can also live in a `.env` file in your project root.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 1,983 words (~9,967 tokens).

“One CLI for all of Google Workspace — Drive, Gmail, Calendar, Sheets, Docs, Slides, Chat, Tasks, Admin, Meet, Forms, Keep, and every other Workspace API. Built for humans and AI agents. Structured JSON output. 100+ agent skills included.”

— opening of SKILL.md by hoodini
name
google-workspace-cli

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills/google-workspace-cli of hoodini/ai-agents-skills.

Open the folder on GitHubat commit f7a43d8

Compare with similar skills

Google Workspace CLI next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Google Workspace CLI compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Google Workspace CLI this skillhoodini/ai-agents-skills282—~10kAutomated safety check: NotesNone
Gwskv0906/pm-kit138—~1.6kAutomated safety check: PassMIT
Bootstrap Google Toolsgoogle/adk-recipes10k—~5kAutomated safety check: WarnApache-2.0
Google Workspaceswarmclawai/swarmclaw687—~680Automated safety check: PassMIT
Apple Mail Setupdavekilleen/Dex493—~2.5kAutomated safety check: PassCustom licence
Google Workspacetaracodlabs/aiden849—~1.1kAutomated safety check: PassApache-2.0

Similar skills

  • Gws

    kv0906/pm-kit

    This skill should be used when the user asks to "set up gws", "install Google Workspace CLI", "connect Gmail to Claude", "manage Google Drive from terminal", "send email from CLI", "check my…

    138 GitHub stars~1.6k tokensUpdated 3 mo ago
    Documents & OfficeAuto-check passed
  • Bootstrap Google Tools

    google/adk-recipes

    Official

    Install/auth CLIs the sandbox lacks - gws (Drive, Gmail, Sheets, Calendar), gcloud, agents-cli, mcp-cli (MCP servers).

    10k GitHub stars~5k tokensUpdated 2 days ago
    Agent WorkflowsAuto-check: warnings
  • Google Workspace

    swarmclawai/swarmclaw

    Use Google Workspace CLI (gws) for Drive, Docs, Sheets, Gmail, Calendar, Chat, and related Workspace API tasks.

    687 GitHub stars~680 tokensUpdated 3 mo ago
    Documents & OfficeAuto-check passed
  • Apple Mail Setup

    davekilleen/Dex

    Set up and verify Apple Mail search on macOS, including the search index that silently returns nothing when it was never built.

    493 GitHub stars~2.5k tokensUpdated 5 days ago
    Documents & OfficeAuto-check passed
  • Google Workspace

    taracodlabs/aiden

    Gmail, Calendar, Drive, Sheets, Docs via Google API (SA / OAuth)

    849 GitHub stars~1.1k tokensUpdated 24 days ago
    Documents & OfficeAuto-check passed
  • Google Workspace

    AlexAI-MCP/hermes-CCC

    Automate Google Workspace — Gmail, Drive, Sheets, Docs, Calendar via Google API Python client or gcloud CLI.

    135 GitHub stars~1.2k tokensUpdated 6 mo ago
    Documents & OfficeAuto-check passed

More from hoodini/ai-agents-skills

All 30 skills in this repo
  • Parallax Scroll-Scrub Landing Page

    hoodini/ai-agents-skills

    Turns a short video into a one-screen landing page where scrolling scrubs through the extracted frames while five text scenes crossfade over the footage.

    282 GitHub stars~3.2k tokensUpdated 2 mo ago
    Auto-check passed
  • Yuv Viral Video

    hoodini/ai-agents-skills

    Edit any selfie or screen-share footage into a viral short-form video in YUV.AI's signature style — Apple-style liquid-glass cards (real CSS backdrop-filter), dark-mode polish, MrBeast-paced cuts…

    282 GitHub stars~7.5k tokensUpdated 2 mo ago
    Auto-check: notes
  • Meta Ads

    hoodini/ai-agents-skills

    Pull, analyze, manage, and CREATE Meta ads (Facebook, Instagram, Messenger, Threads, Click-to-WhatsApp) via the Marketing API.

    282 GitHub stars~4.2k tokensUpdated 2 mo ago
    Auto-check: notes
  • YUV Video Director

    hoodini/ai-agents-skills

    Turns an idea or script into a branded MP4 by routing each scene to HyperFrames, Lottie, Manim or GSAP, wrapping it in one brand frame file, then checking and rendering.

    282 GitHub stars~2.2k tokensUpdated 2 mo ago
    Auto-check passed
  • Video To Landing Page

    hoodini/ai-agents-skills

    Turn any video into a cinematic scroll-driven landing page — Apple-style hero where scrolling progresses the visible frame through the video.

    282 GitHub stars~1.4k tokensUpdated 2 mo ago
    Auto-check passed
  • Mermaid Diagrams

    hoodini/ai-agents-skills

    Create diagrams and visualizations using Mermaid syntax. An agent skill from hoodini/ai-agents-skills.

    282 GitHub starsUsed in 1 repo~1.9k tokens
    Auto-check passed

Questions about Google Workspace CLI

What does Google Workspace CLI do?

Interact with all Google Workspace APIs via the gws CLI. An agent skill from hoodini/ai-agents-skills. Google Workspace CLI is an agent skill from hoodini/ai-agents-skills. Interact with all Google Workspace APIs via the gws CLI.

When should I use Google Workspace CLI?

Google Workspace CLI fits situations like: managing Drive files; sending/reading Gmail; creating Calendar events; reading/writing Sheets/Docs/Slides.

How do I install Google Workspace CLI in Claude Code?

Run `npx skills add hoodini/ai-agents-skills --skill google-workspace-cli -a claude-code`. Or copy the skill folder (skills/google-workspace-cli in hoodini/ai-agents-skills) into .claude/skills/google-workspace-cli in your project. Claude Code loads it when a task matches its description.

How do I install Google Workspace CLI in Codex?

Run `npx skills add hoodini/ai-agents-skills --skill google-workspace-cli -a codex`. Or copy the skill folder (skills/google-workspace-cli in hoodini/ai-agents-skills) into .agents/skills/google-workspace-cli in your project. Codex loads it when a task matches its description.

Can I use Google Workspace CLI in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add hoodini/ai-agents-skills --skill google-workspace-cli -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/google-workspace-cli, .gemini/skills/google-workspace-cli, .github/skills/google-workspace-cli and .opencode/skills/google-workspace-cli in your project.

What does Google Workspace CLI need to run?

Going by SKILL.md and its folder, Google Workspace CLI needs the command-line tools its instructions call (npx, jq, npm, cargo, nix and gcloud) and credentials named GOOGLE_WORKSPACE_CLI_TOKEN. Our summary lists: Node.js; A credential in GOOGLE_WORKSPACE_CLI_TOKEN.

Does Google Workspace CLI access the network?

SKILL.md names 7 domains. In commands or code: github.com, console.cloud.google.com and console.developers.google.com; the agent is likely to contact these when it follows the instructions. As links in the text: developers.google.com, cloud.google.com, modelcontextprotocol.io and npmjs.com. This is read from the text; nothing was executed.

Is Google Workspace CLI safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Google Workspace CLI use?

No licence was found for Google Workspace CLI or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Google Workspace CLI use?

About 10k tokens (SKILL.md is roughly 40k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Google Workspace CLI?

Skills that share tags, products or a category with Google Workspace CLI: Gws (kv0906/pm-kit, 138 stars), Bootstrap Google Tools (google/adk-recipes, 10k stars), Google Workspace (swarmclawai/swarmclaw, 687 stars) and Apple Mail Setup (davekilleen/Dex, 493 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Google Workspace CLI?

hoodini (a GitHub user) maintains it in hoodini/ai-agents-skills, which has 282 GitHub stars. The repository holds 30 skills in this directory. The repository was last updated on July 11, 2026.

Source: hoodini/ai-agents-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.