Back to Skills

Google Workspace CLI (gws)

by Google Workspace

productivitybeginner
Google Workspace CLIagent skillsClaude Code skillGmail automationGoogle Drive AIgwsWorkspace automation

Google shipped a CLI that gives AI agents full access to every Workspace API. Gmail, Drive, Calendar, Sheets, Docs, Chat, Admin, Slides, Forms, Tasks, Keep, Meet, Classroom, and more. 23,700 GitHub stars. 100+ agent skills included. 50 curated recipe workflows. 10 persona skills bundled by role. The architecture is what makes it special. Instead of maintaining a static command list, gws dynamically builds its interface by reading Google's Discovery Service at runtime. When Google adds a new API endpoint, gws picks it up automatically. Zero code changes. Zero updates required. Your agent's capabilities grow every time Google ships. Install globally with npm install -g @googleworkspace/cli, authenticate via OAuth, and Claude Code gets direct access to everything in your Google Workspace. Read emails, create documents, schedule meetings, query spreadsheets, manage Drive files, and chain operations across services in multi-step workflows. The 100+ agent skills are structured reference files (SKILL.md with YAML frontmatter) that tell Claude exactly what commands are available, the correct syntax, and how to chain operations. The 50 recipes handle common multi-step tasks: "summarize unread emails and create a daily digest doc," "find all Drive files modified this week and share with team," "create a calendar event from a Sheets row." The 10 persona skills bundle capabilities by role: Executive Assistant, Project Manager, Sales Ops, Developer, and more. Every response comes as structured JSON with zero boilerplate. Auto-pagination (--page-all) handles large result sets. Dry-run mode (--dry-run) previews operations before execution. Multipart file uploads work natively. Model Armor integration sanitizes responses for safety. The skill works with Claude Code, OpenAI Codex, Cursor, GitHub Copilot, Windsurf, Gemini CLI, and 30+ other AI agents. Install at project level (shared with your team via version control) or globally. Symlink-based installation means updates propagate automatically. If you use Google Workspace and any AI coding agent, this is the integration that turns your agent into a full workspace operator. For more agent skills, browse Skila's agent skills directory. For the AI tools these skills extend, see AI coding tools on Skila. Related: Awesome Agent Skills (VoltAgent) for discovering the broader skills ecosystem.

Installation

npm install -g @googleworkspace/cli

Key Features

  • Dynamic API discovery: auto-detects new Google APIs via Discovery Service at runtime
  • 100+ agent skills covering Gmail, Drive, Calendar, Sheets, Docs, Chat, Admin, and more
  • 50 curated recipe workflows for common multi-step tasks
  • 10 persona skills bundled by role (Executive Assistant, PM, Sales Ops, etc.)
  • Structured JSON output with zero boilerplate on all responses
  • Auto-pagination, dry-run preview, multipart file uploads
  • Works with Claude Code, Codex, Cursor, Copilot, Windsurf, Gemini CLI, and 30+ agents
  • 23,700+ GitHub stars, actively maintained by Google

Use Cases

  • Automating email workflows: summarize, reply, organize, and filter Gmail through AI agents
  • Document management: create, search, share, and organize Google Drive files via conversation
  • Calendar automation: schedule meetings, check availability, and create events from context
  • Spreadsheet operations: query, update, and analyze Google Sheets data through natural language
  • Team productivity: persona skills turn AI agents into role-specific workspace assistants

Related Resources

Weekly AI Digest