google-workspace
Google Workspace CLI (`gws`) brings Google Workspace API automation to the command line, handling Drive files, Docs, Sheets, Gmail messages, Calendar events, and Chat spaces with structured JSON responses. Use it to read, list, and mutate Workspace resources while confirming IDs and respecting API limits.
Google Workspace CLI automates Drive, Docs, Sheets, Gmail, Calendar, and Chat tasks through structured command-line commands.
AI-generated summary based on this skill's SKILL.md
Install
swarmclawai/swarmclaw/google-workspace · repository language: TypeScript
git clone https://github.com/swarmclawai/swarmclaw
cp -r swarmclaw/skills/google-workspace ~/.claude/skills/google-workspaceFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
What are the main google workspace cli commands?
Google Workspace CLI (`gws`) provides command-line access to Workspace APIs for Drive, Docs, Sheets, Gmail, Calendar, and Chat. Core commands let you list files, retrieve documents, query messages, manage events, and interact with chat spaces—all returning structured JSON output for easy scripting and automation.
How do I use google workspace automation with gws?
Google Workspace CLI enables automation by replacing manual HTTP calls with structured commands. You can automate Drive file operations, Gmail message retrieval, Calendar event management, and Chat interactions programmatically. Each command respects API limits and returns consistent JSON, making it ideal for batch workflows and integration scripts.
Can I list Gmail messages and Google Drive files via CLI?
Yes. Google Workspace CLI supports `gws gmail users messages` to list Gmail messages and `gws drive files list` to retrieve Drive files. Both commands return structured JSON output, letting you filter, parse, and process results in automation pipelines while respecting Google Workspace API rate limits.
What Google Workspace resources does gws support?
Google Workspace CLI covers Drive files, Google Docs, Sheets, Gmail messages, Calendar events, and Chat spaces. You can read, list, and mutate these resources through dedicated command groups. The tool provides consistent JSON responses and confirms resource IDs to ensure reliable automation across your Workspace environment.
How do I get started with google workspace cli installation?
Google Workspace CLI is distributed under the MIT license. Installation typically involves downloading the binary or installing via package manager. Once installed, configure authentication with your Workspace credentials, then use `gws help` or command-specific docs to explore available operations for Docs, Sheets, Drive, Gmail, Calendar, and Chat.
SKILL.md
rendered from the published skill — quoted content, verbatim
Google Workspace CLI
Use gws when the task is about Google Workspace resources or Google Workspace API automation.
Prefer gws over generic HTTP calls when possible because it already knows the Workspace API surface and returns structured JSON by default.
Rules
- Start with read/list/get commands before mutating Workspace state.
- Confirm IDs first: document IDs, spreadsheet IDs, file IDs, message IDs, calendar IDs, space IDs.
- Do not run interactive auth flows from an agent tool call. If auth is missing, report that
gwsneeds to be configured in plugin settings or via a manual terminal login. - Keep commands machine-readable. Prefer JSON output and parse it instead of scraping human text.
- For large list operations, limit the scope first, then page
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 1 file
skills/google-workspace/SKILL.md