New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Google Workspace

by swarmclawai in swarmclawai/swarmclaw

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

MITAuto-check passedDocuments & Office

Install Google Workspace

skills CLI
$ npx skills add swarmclawai/swarmclaw --skill google-workspace -a claude-code

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

GitHub CLI
$ gh skill install swarmclawai/swarmclaw google-workspace --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/swarmclawai/swarmclaw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/google-workspace .claude/skills/google-workspace && 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
GitHub stars
688
Token cost
~680 tokens
SKILL.md length
250 words
Files
1
Skills in repo
12
Repo updated
First seen
Licence
MIT

At a glance

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

  • Works in 5 steps: Start with read/list/get commands before… → Confirm IDs first: document IDs,… → Do not run interactive auth flows from… → …
  • Tasks that involve Cloud office suites
  • SKILL.md covers Rules, Common Commands, Tool Usage In SwarmClaw and Error Handling
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Google Workspace is an agent skill from swarmclawai/swarmclaw. Use Google Workspace CLI (gws) for Drive, Docs, Sheets, Gmail, Calendar, Chat, and related Workspace API tasks.

Its SKILL.md is about 680 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, Gmail and Model Context Protocol. The repository describes itself as: Open-source self-hosted AI agent runtime and multi-agent framework for autonomous agent swarms. Agent memory, MCP tools, schedules, delegation, and 23+ LLM providers (Claude… The licence is MIT.

When your agent uses it

  • Tasks that involve Cloud office suites
  • Tasks that involve Email management

Example prompts

  • “/google-workspace”

Workflow steps

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

  1. Start with read/list/get commands before mutating Workspace state.
  2. Confirm IDs first: document IDs, spreadsheet IDs, file IDs, message IDs, calendar IDs, space IDs.
  3. Do not run interactive auth flows from an agent tool call. If auth is missing, report that gws needs to be configured in plugin settings…
  4. Keep commands machine-readable. Prefer JSON output and parse it instead of scraping human text.
  5. For large list operations, limit the scope first, then page or filter.

What it can do on your machine

Read from SKILL.md and the folder at commit ed38ba5. 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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

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

  • Network

    No URLs in SKILL.md.

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

  • Credentials

    Names no API keys, tokens, secrets or passwords.

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

Context cost

Google Workspace loads about 680 tokens when it runs. Until then it costs about 33 tokens; SKILL.md has 250 words of instructions outside code blocks.

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

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 passed

The automated check found no risky patterns in SKILL.md.

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

The full file from swarmclawai/swarmclaw at commit ed38ba5, republished under its MIT licence (© swarmclawai). 250 words, ~680 tokens.

Download SKILL.mdSave it as .claude/skills/google-workspace/SKILL.md (or your agent's skills folder).
name
google-workspace
description
Use Google Workspace CLI (`gws`) for Drive, Docs, Sheets, Gmail, Calendar, Chat, and related Workspace API tasks.
homepage
https://github.com/googleworkspace/cli

Google Workspace CLI

Use gws when the task is about Google Workspace resources or Google Workspace API automation.

Prefer gws over generic HTTP calls when possible because it already knows the Workspace API surface and returns structured JSON by default.

Rules

  1. Start with read/list/get commands before mutating Workspace state.
  2. Confirm IDs first: document IDs, spreadsheet IDs, file IDs, message IDs, calendar IDs, space IDs.
  3. Do not run interactive auth flows from an agent tool call. If auth is missing, report that gws needs to be configured in plugin settings or via a manual terminal login.
  4. Keep commands machine-readable. Prefer JSON output and parse it instead of scraping human text.
  5. For large list operations, limit the scope first, then page or filter.

Common Commands

Check installation and health:

bash
gws doctor

Inspect help for a resource or method:

bash
gws help
gws drive help
gws drive files help

Google Docs:

bash
gws docs get --document-id <DOC_ID>

Google Drive:

bash
gws drive files list --params '{"pageSize":10}'
gws drive files get --file-id <FILE_ID>

Google Sheets:

bash
gws sheets spreadsheets get --spreadsheet-id <SPREADSHEET_ID>

Gmail:

bash
gws gmail users messages list --user-id me --params '{"maxResults":10}'
gws gmail users messages get --user-id me --message-id <MESSAGE_ID>

Google Calendar:

bash
gws calendar events list --calendar-id primary --params '{"maxResults":10,"singleEvents":true}'

Google Chat:

bash
gws chat spaces messages list --parent spaces/<SPACE_ID>

Tool Usage In SwarmClaw

When using the google_workspace tool:

  • Put the gws command after the binary into args, for example: {"args":["drive","files","list"],"params":{"pageSize":5}}
  • Use params for --params
  • Use jsonInput for --json
  • Use pageAll: true when you intentionally want all pages
  • Use dryRun: true before risky mutations if you are unsure

Error Handling

  • If gws is missing: tell the user to install Google Workspace CLI.
  • If auth is missing or expired: tell the user to configure the plugin settings or authenticate gws manually.
  • If a command fails because an ID is missing: switch to a list/search command first and find the right ID.

© swarmclawai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/google-workspace of swarmclawai/swarmclaw.

Open the folder on GitHubat commit ed38ba5

Compare with similar skills

Google Workspace 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 compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Google Workspace this skillswarmclawai/swarmclaw688—~680Automated safety check: PassMIT
Managing Google Workspacetaylorwilsdon/google_workspace_mcp3.3k—~2.9kAutomated safety check: PassMIT
Gwskv0906/pm-kit138—~1.6kAutomated safety check: PassMIT
Google Workspacemitsuhiko/agent-stuff3.2k—~919Automated safety check: PassApache-2.0
Apple Mail Setupdavekilleen/Dex493—~2.5kAutomated safety check: PassMIT
Google Workspace CLIhoodini/ai-agents-skills282—~10kAutomated safety check: NotesNone

Similar skills

  • Managing Google Workspace

    taylorwilsdon/google_workspace_mcp

    Manages Google Workspace operations across 12 services (Gmail, Drive, Calendar, Docs, Sheets, Slides, Forms, Tasks, Contacts, Chat, Apps Script, Custom Search).

    3.3k GitHub stars~2.9k tokensUpdated 2 days ago
    Documents & OfficeAuto-check passed

  • 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

  • Google Workspace

    mitsuhiko/agent-stuff

    Access Google Workspace APIs (Drive, Docs, Calendar, Gmail, Sheets, Slides, Chat, People) via local helper scripts without MCP.

    3.2k GitHub stars~919 tokensUpdated 11 days 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 today
    Documents & OfficeAuto-check passed

  • Google Workspace CLI

    hoodini/ai-agents-skills

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

    282 GitHub stars~10k tokensUpdated 2 mo ago
    Documents & OfficeAuto-check: notes

  • 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 today
    Agent WorkflowsAuto-check: warnings

More from swarmclawai/swarmclaw

All 12 skills in this repo

  • Openai Image Gen

    swarmclawai/swarmclaw

    Generate images via OpenAI Images API (GPT Image, DALL-E 3, DALL-E 2).

    688 GitHub stars~705 tokensUpdated 3 mo ago
    Auto-check passed

  • Skill Creator

    swarmclawai/swarmclaw

    Create, edit, improve, or audit skills for SwarmClaw agents.

    688 GitHub stars~1.4k tokensUpdated 3 mo ago
    Auto-check passed

  • Nano Banana Pro

    swarmclawai/swarmclaw

    Generate or edit images via Gemini 3 Pro Image (Nano Banana Pro).

    688 GitHub stars~481 tokensUpdated 3 mo ago
    Auto-check passed

  • Coding Agent

    swarmclawai/swarmclaw

    Delegate coding tasks to external coding agents (Claude Code, Codex, Pi, OpenCode) via shell.

    688 GitHub stars~900 tokensUpdated 3 mo ago
    Auto-check passed

  • GitHub

    swarmclawai/swarmclaw

    GitHub operations via gh CLI: issues, PRs, CI runs, code review, API queries.

    688 GitHub stars~820 tokensUpdated 3 mo ago
    Auto-check passed

  • Swarmclaw

    swarmclawai/swarmclaw

    AI agent runtime and multi-agent orchestration platform. An agent skill from swarmclawai/swarmclaw.

    688 GitHub stars~2k tokensUpdated 3 mo ago
    Auto-check passed

Works with

Categories

Questions about Google Workspace

What does Google Workspace do?

Use Google Workspace CLI (gws) for Drive, Docs, Sheets, Gmail, Calendar, Chat, and related Workspace API tasks. Google Workspace is an agent skill from swarmclawai/swarmclaw. Use Google Workspace CLI (gws) for Drive, Docs, Sheets, Gmail, Calendar, Chat, and related Workspace API tasks.

When should I use Google Workspace?

Google Workspace fits situations like: tasks that involve Cloud office suites; tasks that involve Email management.

How do I install Google Workspace in Claude Code?

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

How do I install Google Workspace in Codex?

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

Can I use Google Workspace 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 swarmclawai/swarmclaw --skill google-workspace -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, .gemini/skills/google-workspace, .github/skills/google-workspace and .opencode/skills/google-workspace in your project.

What does Google Workspace need to run?

SKILL.md names no scripts, command-line tools or credentials: Google Workspace is instructions for the agent only.

Does Google Workspace access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Google Workspace safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Google Workspace use?

Google Workspace is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Google Workspace use?

About 680 tokens (SKILL.md is roughly 2.7k 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?

Skills that share tags, products or a category with Google Workspace: Managing Google Workspace (taylorwilsdon/google_workspace_mcp, 3.3k stars), Gws (kv0906/pm-kit, 138 stars), Google Workspace (mitsuhiko/agent-stuff, 3.2k 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?

swarmclawai (a GitHub organization) maintains it in swarmclawai/swarmclaw, which has 688 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on June 30, 2026.

Source: swarmclawai/swarmclaw on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.