Google Workspace CLI (gws)

What it does

This skill documents how to use the gws CLI as a single interface to Google Workspace APIs. It explains installation, authentication flows (interactive, service account, headless/CI), command structure, common examples for Drive/Gmail/Calendar/Sheets/Docs/Chat, and MCP server integration for exposing tools to agents. The CLI produces structured JSON suitable for programmatic agents.

When to use it

Use when an agent or operator needs to interact with Google Workspace programmatically: listing or uploading Drive files, sending emails, creating calendar events, manipulating Sheets/Docs, or starting an MCP server to expose Workspace tools to LLMs. Triggers include mentions of gws, Google Workspace, Drive, Gmail, Calendar, Sheets, Docs, Chat, or MCP server integration.

What's included

• Scripts: none bundled with this SKILL.md itself, but the repo contains many example skill files and recipes for common workflows.
• References: extensive command examples, troubleshooting, and workflow recipes are embedded in the skill body and linked docs.
• Instructions: detailed auth guidance (gcloud-based setup, manual OAuth, service accounts), command patterns, global flags, and example recipes for common tasks.

Compatible agents

Ideal for agents that can run CLIs or spawn subprocesses (Claude Code, Copilot/Codex-style tooling, Cursor) and for MCP-capable clients that can consume the gws MCP server.