How do I install the Google Workspace skill?

Run npx skillmds@latest add tuyv/google-workspace in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Google Workspace safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Google Workspace?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Google Workspace free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Google Workspace?

tuyv (@tuyv) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Google Workspace by tuyv — Agent Skill

Name: Google Workspace
Author: tuyv

File contents

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

Start with read/list/get commands before mutating Workspace state.
Confirm IDs first: document IDs, spreadsheet IDs, file IDs, message IDs, calendar IDs, space IDs.
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.
Keep commands machine-readable. Prefer JSON output and parse it instead of scraping human text.
For large list operations, limit the scope first, then page or filter.

Common Commands

Check installation and health:

gws doctor

Inspect help for a resource or method:

gws help
gws drive help
gws drive files help

Google Docs:

gws docs get --document-id <DOC_ID>

Google Drive:

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

Google Sheets:

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

Gmail:

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:

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

Google Chat:

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.

---name: google-workspacedescription: Use Google Workspace CLI (`gws`) for Drive, Docs, Sheets, Gmail, Calendar, Chat, and related Workspace API tasks.---# Google Workspace CLIUse `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.## Rules1. 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 CommandsCheck installation and health:```bashgws doctor```Inspect help for a resource or method:```bashgws helpgws drive helpgws drive files help```Google Docs:```bashgws docs get --document-id <DOC_ID>```Google Drive:```bashgws drive files list --params '{"pageSize":10}'gws drive files get --file-id <FILE_ID>```Google Sheets:```bashgws sheets spreadsheets get --spreadsheet-id <SPREADSHEET_ID>```Gmail:```bashgws gmail users messages list --user-id me --params '{"maxResults":10}'gws gmail users messages get --user-id me --message-id <MESSAGE_ID>```Google Calendar:```bashgws calendar events list --calendar-id primary --params '{"maxResults":10,"singleEvents":true}'```Google Chat:```bashgws chat spaces messages list --parent spaces/<SPACE_ID>```## Tool Usage In SwarmClawWhen 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.

Frequently asked questions

Google Workspace