operations / skill
Google Workspace CLI (gws)
A command-line tool for Google Workspace APIs such as Drive, Gmail, Calendar and Sheets, with structured JSON output and agent skills.
At a glance
- Purpose
- A command-line tool for Google Workspace APIs such as Drive, Gmail, Calendar and Sheets, with structured JSON output and agent skills.
- Runs in
- Local agent with shell
- Operating systems
- macOS, Linux
- Needs
- Runtime: Not stated; Needs internet: Yes; Needs accounts or API keys beyond your agent: Yes
- Files and data
- Reads files: Yes; Writes files: Yes; Sends data to other services: Yes
- Tool type
- Skill
- Delivery
- From GitHub
- Version
- Latest on the main branch
- Access
- Code on GitHub
- Compatibility
- According to the README: pre-built binaries by operating system and architecture, an npm package, building from source with cargo, a Nix flake, and Homebrew on macOS and Linux. For agents, it describes skills installed with the skills tool, a copy or symlink setup for OpenClaw, and a Gemini CLI extension. The README describes authentication through interactive login, exported credentials, a service account or a pre-obtained access token.
- External costs
- The repository is Apache-2.0 licensed and the README states no pricing. It lists a Google Cloud project as a prerequisite and mentions an environment variable for the project used for quota and billing. The README describes a Google Cloud Model Armor integration but gives no prices for it. Your coding agent or model provider may charge for usage.
- Permissions
- The README describes access through your Google account credentials and selected OAuth scopes. The README says the Gemini CLI extension gives agents direct access to gws commands and Workspace skills and automatically inherits terminal credentials. The README shows global npm installs and OpenClaw skill copies or symlinks under ~/.openclaw/skills/. The README says OpenClaw can install the CLI through npm when it is missing. The README describes configuration and credential files under ~/.config/gws, OS-keyring access or a file-backed encryption key, and unmasked credential export for headless use. The README says authentication setup creates a Cloud project and enables APIs, and describes browser automation for account selection and OAuth consent. The README lists commands for messages, uploads, events and document or spreadsheet writes, watchers for Gmail and Workspace events, and replacement of all files in an Apps Script project with local files.
- Usage terms
- Apache License 2.0, as stated in the repository. See its LICENSE file for the exact terms.
Code on GitHub
googleworkspace/cli
Apache-2.0Google Workspace CLI — one command-line tool for Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin, and more. Dynamically built from Google Discovery Service. Includes AI agent skills.
Topics: agent-skills ai-agent automation cli discovery-api gemini-cli-extension google-admin google-api
Public GitHub data fetched · 0 days old
Skill folders in this repository (95)
Folders that contain a SKILL.md file, from GitHub's file list on .
skills/gws-admin-reportsskills/gws-calendarskills/gws-calendar-agendaskills/gws-calendar-insertskills/gws-chatskills/gws-chat-sendskills/gws-classroomskills/gws-docsskills/gws-docs-writeskills/gws-driveskills/gws-drive-uploadskills/gws-eventsskills/gws-events-renewskills/gws-events-subscribeskills/gws-formsskills/gws-gmailskills/gws-gmail-forwardskills/gws-gmail-readskills/gws-gmail-replyskills/gws-gmail-reply-allskills/gws-gmail-sendskills/gws-gmail-triageskills/gws-gmail-watchskills/gws-keepskills/gws-meetskills/gws-modelarmorskills/gws-modelarmor-create-templateskills/gws-modelarmor-sanitize-promptskills/gws-modelarmor-sanitize-responseskills/gws-peopleskills/gws-scriptskills/gws-script-pushskills/gws-sharedskills/gws-sheetsskills/gws-sheets-appendskills/gws-sheets-readskills/gws-slidesskills/gws-tasksskills/gws-workflowskills/gws-workflow-email-to-taskskills/gws-workflow-file-announceskills/gws-workflow-meeting-prepskills/gws-workflow-standup-reportskills/gws-workflow-weekly-digestskills/persona-content-creatorskills/persona-customer-supportskills/persona-event-coordinatorskills/persona-exec-assistantskills/persona-hr-coordinatorskills/persona-it-adminskills/persona-project-managerskills/persona-researcherskills/persona-sales-opsskills/persona-team-leadskills/recipe-backup-sheet-as-csvskills/recipe-batch-invite-to-eventskills/recipe-block-focus-timeskills/recipe-bulk-download-folderskills/recipe-collect-form-responsesskills/recipe-compare-sheet-tabsskills/recipe-copy-sheet-for-new-monthskills/recipe-create-classroom-courseskills/recipe-create-doc-from-templateskills/recipe-create-events-from-sheetskills/recipe-create-expense-trackerskills/recipe-create-feedback-formskills/recipe-create-gmail-filterskills/recipe-create-meet-spaceskills/recipe-create-presentationskills/recipe-create-shared-driveskills/recipe-create-task-listskills/recipe-create-vacation-responderskills/recipe-draft-email-from-docskills/recipe-email-drive-linkskills/recipe-find-free-timeskills/recipe-find-large-filesskills/recipe-forward-labeled-emailsskills/recipe-generate-report-from-sheetskills/recipe-label-and-archive-emailsskills/recipe-log-deal-updateskills/recipe-organize-drive-folderskills/recipe-plan-weekly-scheduleskills/recipe-post-mortem-setupskills/recipe-reschedule-meetingskills/recipe-review-meet-participantsskills/recipe-review-overdue-tasksskills/recipe-save-email-attachmentsskills/recipe-save-email-to-docskills/recipe-schedule-recurring-eventskills/recipe-send-team-announcementskills/recipe-share-doc-and-notifyskills/recipe-share-event-materialsskills/recipe-share-folder-with-teamskills/recipe-sync-contacts-to-sheetskills/recipe-watch-drive-changes
What it does
gws is a command-line tool for Google Workspace APIs with accompanying agent skills. The README says it reads Google's Discovery Service at runtime to build commands dynamically. The README names Drive, Gmail, Calendar, Sheets, Docs and Chat and describes structured JSON output.The README lists helper commands prefixed with + for jobs including Gmail messages, spreadsheet rows, Drive uploads, calendar agendas and standup reports. The README describes --dry-run for previewing requests and a Model Armor integration for scanning API responses for prompt injection.
The README describes API skills, workflow helpers and recipes, with installation through the skills tool, an OpenClaw setup or a Gemini CLI extension. The README says this is not an officially supported Google product and warns of breaking changes before v1.0.
Who it is for
People who work with Google Workspace from a terminal, scripts or an AI coding agent.Example tasks
List recent Drive files with gws drive files list --params '{"pageSize": 10}'Show the calendar agenda with gws calendar +agenda
Get a standup summary of today's meetings and open tasks with gws workflow +standup-report
Inspect a method's request and response schema with gws schema drive.files.list
Create a spreadsheet with gws sheets spreadsheets create --json '{"properties": {"title": "Q1 Budget"}}'