skill-gws_skill

Overview

This skill is the official Google Workspace CLI (gws) that exposes Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin, and every Workspace API via a single command-line interface. It dynamically builds commands from the Google Discovery Service, supports native MCP server mode for AI agents, and is suitable for scripting, automation, and integrating Workspace APIs into agent workflows.

How this skill works

gws discovers and exposes every Workspace API endpoint as CLI commands and structured JSON I/O. It supports interactive auth (OAuth or service account), streaming pagination, dry-run previews, and an MCP server mode that publishes APIs as tools for AI agents. Commands accept params and JSON payloads and produce machine-friendly JSON output for piping into jq or other tools.

When to use it

• Automating email, calendar, and Drive workflows from scripts or CI
• Exposing Workspace capabilities as tools for AI agents via MCP server mode
• Running ad-hoc API calls without writing client code
• Batch operations and backups across Drive, Gmail, and Sheets
• Integrating Workspace APIs into observability or admin tooling

Best practices

• Perform one-time auth setup (gws auth setup or service account) before automation
• Prefer compact MCP tool-mode to reduce agent context when exposing many endpoints
• Use dry-run to validate requests before executing destructive operations
• Pipe JSON output to jq or structured parsers to build reliable scripts
• Scope MCP exposure to only needed services (e.g., drive,gmail,calendar)

Example use cases

• Start an MCP server to let an AI agent read and compose emails and schedule meetings
• List and export recent Drive files to create automated backups or inventory reports
• Create and populate a spreadsheet from API-derived metrics or logs
• Automate user and group management tasks in Admin with service account auth
• Send alerts to Google Chat spaces from monitoring scripts