A powerful command-line interface providing seamless access to the entire Google Workspace ecosystem for AI agents and developers.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install gws
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install gws using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is gws: Google Workspace CLI?
The gws skill is an integration of the official Google Workspace CLI into the Openclaw Skills ecosystem. It provides a robust, ergonomic interface for interacting with Gmail, Google Calendar, Drive, Sheets, Docs, and over a dozen other Google services directly from the command line. By bridging the gap between local terminal environments and the Google Cloud, it enables AI agents to perform complex cross-service workflows with high precision.
Built for speed and flexibility, this tool supports both high-level helper commands for common tasks like triaging emails or checking agendas, and low-level raw API access for granular control. Whether you are automating document management or building custom notification systems, gws serves as the essential connectivity layer for Google services within Openclaw Skills.
gws: Google Workspace CLI Use Cases
- Triaging unread emails and summarizing priority messages using terminal-based workflows.
- Automating calendar management, including fetching daily agendas and inserting new events.
- Uploading and organizing files in Google Drive with automatic metadata handling.
- Generating cross-service reports, such as combining meeting notes from Calendar with tasks from Gmail.
- Accessing raw Google API endpoints for custom data extraction and manipulation.
How gws: Google Workspace CLI Works
- Authentication: The skill uses OAuth 2.0 to securely connect your local environment to your Google account via gws auth login.
- Command Parsing: Users or AI agents issue commands using the gws syntax, which includes both ergonomic shortcuts (+agenda) and structured API methods.
- API Interaction: The CLI translates these commands into REST API calls directed at the Google Workspace backend.
- Response Processing: Data is returned in multiple formats (JSON, Table, YAML, or CSV) and can be auto-paginated for large datasets.
- Output Delivery: The formatted results are passed back to the terminal or calling agent for further action or display.
gws: Google Workspace CLI Setup
To integrate this capability into your Openclaw Skills environment, install the package and authenticate:
# Install the Google Workspace CLI via npm
npm install -g @googleworkspace/cli
# Verify the installation
gws auth status
# Log in to your Google account (this will open a browser window)
gws auth login
# For full access to all services, use the full scope flag
gws auth login --full
gws: Google Workspace CLI Data Schema & Taxonomy
The gws skill handles structured data across various Google services. It supports specific output flags to define the schema of the returned data.
| Format | Usage Description |
|---|---|
| JSON | Default machine-readable format for agent processing. |
| Table | Human-readable grid format for terminal display. |
| NDJSON | Used with --page-all for streaming large datasets. |
| CSV/YAML | Alternative formats for data export and configuration. |
Configuration and tokens are stored locally in ~/.config/gws/ to maintain session persistence.
gws: Google Workspace CLI Advanced Features
- Auto-Pagination: Use the
--page-allflag to automatically fetch all records across multiple API pages. - Dry-Run Mode: Validate complex commands and parameters without making actual API changes using
--dry-run. - Schema Discovery: Explore API definitions and reference resolutions directly via
gws schema. - Cross-Service Workflows: Execute predefined complex tasks like
+standup-reportthat aggregate data from multiple Google apps. - Environment Variable Support: Override default credentials using variables like
GOOGLE_WORKSPACE_CLI_TOKENfor CI/CD or headless environments.
SKILL.md
Loading
Related Openclaw Skills
API Gateway Starter
A production-ready API Gateway providing robust authentication, rate limiting, and load balancing for high-performance service architectures.
Spring Boot 2 to 3 Migration Expert
A specialized migration engine that automates the transition from Spring Boot 2.7.x to 3.x using a recipe-first OpenRewrite workflow and automated verification.
ContentForge API Skill
A professional-grade content generation skill utilizing the ContentForge API to produce high-quality, template-based text for marketing, blogs, and business needs.
Git Version Control
A robust git-based version control system designed to safeguard OpenClaw configuration files through automated checkpoints and easy rollbacks.
Darkest Dungeon DM
A cold and ruthless AI Dungeon Master that brings the high-stakes, gothic horror mechanics of Darkest Dungeon to your AI agent workflows.
Echo Skill
A streamlined HTTP-based utility designed to validate connectivity and verify parameter passing for AI agent workflows.
Featured*
