
from ai-agents-skills173
Guide for using the gws CLI to access Google Workspace APIs (Drive, Gmail, Calendar, Sheets, Docs, Chat, etc.) from agents or scripts with structured JSON outpu
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.
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.
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.
Comprehensive skill for using the gws CLI to access all Google Workspace APIs (Drive, Gmail, Calendar, Sheets, Docs, Slides, Chat, Tasks, Admin, etc.) with structured JSON output. SKILL.md is exceptionally well-written with detailed auth setup, per-service command examples, workflow helpers, MCP server integration, troubleshooting, and an agent decision guide. No bundled scripts — purely a reference/documentation skill. No security concerns beyond standard OAuth credential handling which is well-documented with encryption-at-rest noted.
Outstanding documentation quality — one of the most thorough SKILL.md files seen. Covers auth setup (6 methods), 20+ Google services with examples, workflow helpers, MCP integration, personas, and troubleshooting. Deductions: -12 for shell injection risk patterns in bash examples with single-quote escaping inside --params (minor, user-facing not programmatic), -6 for env var credentials (GOOGLE_WORKSPACE_CLI_TOKEN) being plaintext env vars without security warnings. Architecture is excellent: frontmatter complete, clear sections, progressive disclosure via collapsible details. No scripts present so code quality reflects SKILL.md quality only.