{"api_version":"1","slug":"google-workspace-cli-gws-ed068e5b","url":"https://skillsoutpost.com/agents/google-workspace-cli-gws-ed068e5b","item_type":"skill","category":"operations","runs_in":["local_agent"],"os":["macos","linux"],"needs_network":"yes","needs_accounts":"yes","reads_files":"yes","writes_files":"yes","sends_data":"yes","access":"github","access_type":"github","at_a_glance":{"runs_in":["local_agent"],"os":["macos","linux"],"needs_network":"yes","needs_accounts":"yes","reads_files":"yes","writes_files":"yes","sends_data":"yes","access_type":"github","tool_type":"skill","delivery":"github","interface_type":"other","untrusted_creator_content":{"purpose":"A command-line tool for Google Workspace APIs such as Drive, Gmail, Calendar and Sheets, with structured JSON output and agent skills.","needs_runtime":null,"version":"Latest on the main branch","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."}},"interface_type":"other","delivery_mode":"creator","code_host":"github","provenance":"github_index","published_at":1791761280,"rating":null,"downloads":0,"verified":null,"creator":{"login":"googleworkspace","url":null},"untrusted_creator_content":{"name":"Google Workspace CLI (gws)","tagline":"A command-line tool for Google Workspace APIs such as Drive, Gmail, Calendar and Sheets, with structured JSON output and agent skills.","creator_name":"googleworkspace","product_version":"Latest on the main branch","needs_runtime":null,"description":"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.\n\nThe 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.\n\nThe 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.","intended_users":"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}'\nShow the calendar agenda with gws calendar +agenda\nGet a standup summary of today's meetings and open tasks with gws workflow +standup-report\nInspect a method's request and response schema with gws schema drive.files.list\nCreate a spreadsheet with gws sheets spreadsheets create --json '{\"properties\": {\"title\": \"Q1 Budget\"}}'","setup_instructions":"According to the README, the recommended install is the pre-built binary for your OS from GitHub Releases, placed in your PATH. It also lists npm install -g @googleworkspace/cli, building with cargo, a Nix flake and brew install googleworkspace-cli. Then run gws auth setup and gws auth login. For the agent skills, the README gives npx skills add followed by the repository address, and a Gemini CLI extension install after gws auth setup. The README has the exact commands.","limitations":"The README lists a Google account with Workspace access and a Google Cloud project for OAuth credentials as prerequisites. It lists Node.js 18+ for npm installation, and offers pre-built binaries, building with cargo, a Nix flake and Homebrew on macOS and Linux. The README says gws auth setup requires gcloud, with manual OAuth setup as an alternative. For testing-mode OAuth, the README requires adding your account as a test user and warns that the recommended scope preset exceeds the approximately 25-scope limit; it suggests selecting services with gws auth login -s drive,gmail,sheets. The README says this is not an officially supported Google product and warns of breaking changes before v1.0. The repository can change at any time; check its README before you install.","data_handling":"The README says commands call Google Workspace APIs and return structured JSON. It says the Discovery document and your account timezone are cached for 24 hours, and that logging to stderr or JSON log files is off by default. The README describes sending prompts or responses through Google Cloud Model Armor templates for sanitization, including scanning API responses for prompt injection. It lists GOOGLE_WORKSPACE_CLI_SANITIZE_MODE as warn by default, with block as an alternative. The README does not describe telemetry. What your coding agent and model provider receive depends on what the agent reads with the tool.","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.","creator_website":null,"documentation_url":null,"support_url":null,"repository_url":null,"video_url":null},"github":{"fetched_at":1791851719,"untrusted_third_party_content":{"source_url":null,"github_repo_id":1171026502,"full_name":"googleworkspace/cli","description":"Google 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.","language":"Rust","license_spdx":"Apache-2.0","topics":["agent-skills","ai-agent","automation","cli","discovery-api","gemini-cli-extension","google-admin","google-api"],"stars":31414,"forks":1878,"skills":{"total":95,"paths":[{"path":"skills/gws-admin-reports","url":null},{"path":"skills/gws-calendar","url":null},{"path":"skills/gws-calendar-agenda","url":null},{"path":"skills/gws-calendar-insert","url":null},{"path":"skills/gws-chat","url":null},{"path":"skills/gws-chat-send","url":null},{"path":"skills/gws-classroom","url":null},{"path":"skills/gws-docs","url":null},{"path":"skills/gws-docs-write","url":null},{"path":"skills/gws-drive","url":null},{"path":"skills/gws-drive-upload","url":null},{"path":"skills/gws-events","url":null},{"path":"skills/gws-events-renew","url":null},{"path":"skills/gws-events-subscribe","url":null},{"path":"skills/gws-forms","url":null},{"path":"skills/gws-gmail","url":null},{"path":"skills/gws-gmail-forward","url":null},{"path":"skills/gws-gmail-read","url":null},{"path":"skills/gws-gmail-reply","url":null},{"path":"skills/gws-gmail-reply-all","url":null},{"path":"skills/gws-gmail-send","url":null},{"path":"skills/gws-gmail-triage","url":null},{"path":"skills/gws-gmail-watch","url":null},{"path":"skills/gws-keep","url":null},{"path":"skills/gws-meet","url":null},{"path":"skills/gws-modelarmor","url":null},{"path":"skills/gws-modelarmor-create-template","url":null},{"path":"skills/gws-modelarmor-sanitize-prompt","url":null},{"path":"skills/gws-modelarmor-sanitize-response","url":null},{"path":"skills/gws-people","url":null},{"path":"skills/gws-script","url":null},{"path":"skills/gws-script-push","url":null},{"path":"skills/gws-shared","url":null},{"path":"skills/gws-sheets","url":null},{"path":"skills/gws-sheets-append","url":null},{"path":"skills/gws-sheets-read","url":null},{"path":"skills/gws-slides","url":null},{"path":"skills/gws-tasks","url":null},{"path":"skills/gws-workflow","url":null},{"path":"skills/gws-workflow-email-to-task","url":null},{"path":"skills/gws-workflow-file-announce","url":null},{"path":"skills/gws-workflow-meeting-prep","url":null},{"path":"skills/gws-workflow-standup-report","url":null},{"path":"skills/gws-workflow-weekly-digest","url":null},{"path":"skills/persona-content-creator","url":null},{"path":"skills/persona-customer-support","url":null},{"path":"skills/persona-event-coordinator","url":null},{"path":"skills/persona-exec-assistant","url":null},{"path":"skills/persona-hr-coordinator","url":null},{"path":"skills/persona-it-admin","url":null},{"path":"skills/persona-project-manager","url":null},{"path":"skills/persona-researcher","url":null},{"path":"skills/persona-sales-ops","url":null},{"path":"skills/persona-team-lead","url":null},{"path":"skills/recipe-backup-sheet-as-csv","url":null},{"path":"skills/recipe-batch-invite-to-event","url":null},{"path":"skills/recipe-block-focus-time","url":null},{"path":"skills/recipe-bulk-download-folder","url":null},{"path":"skills/recipe-collect-form-responses","url":null},{"path":"skills/recipe-compare-sheet-tabs","url":null},{"path":"skills/recipe-copy-sheet-for-new-month","url":null},{"path":"skills/recipe-create-classroom-course","url":null},{"path":"skills/recipe-create-doc-from-template","url":null},{"path":"skills/recipe-create-events-from-sheet","url":null},{"path":"skills/recipe-create-expense-tracker","url":null},{"path":"skills/recipe-create-feedback-form","url":null},{"path":"skills/recipe-create-gmail-filter","url":null},{"path":"skills/recipe-create-meet-space","url":null},{"path":"skills/recipe-create-presentation","url":null},{"path":"skills/recipe-create-shared-drive","url":null},{"path":"skills/recipe-create-task-list","url":null},{"path":"skills/recipe-create-vacation-responder","url":null},{"path":"skills/recipe-draft-email-from-doc","url":null},{"path":"skills/recipe-email-drive-link","url":null},{"path":"skills/recipe-find-free-time","url":null},{"path":"skills/recipe-find-large-files","url":null},{"path":"skills/recipe-forward-labeled-emails","url":null},{"path":"skills/recipe-generate-report-from-sheet","url":null},{"path":"skills/recipe-label-and-archive-emails","url":null},{"path":"skills/recipe-log-deal-update","url":null},{"path":"skills/recipe-organize-drive-folder","url":null},{"path":"skills/recipe-plan-weekly-schedule","url":null},{"path":"skills/recipe-post-mortem-setup","url":null},{"path":"skills/recipe-reschedule-meeting","url":null},{"path":"skills/recipe-review-meet-participants","url":null},{"path":"skills/recipe-review-overdue-tasks","url":null},{"path":"skills/recipe-save-email-attachments","url":null},{"path":"skills/recipe-save-email-to-doc","url":null},{"path":"skills/recipe-schedule-recurring-event","url":null},{"path":"skills/recipe-send-team-announcement","url":null},{"path":"skills/recipe-share-doc-and-notify","url":null},{"path":"skills/recipe-share-event-materials","url":null},{"path":"skills/recipe-share-folder-with-team","url":null},{"path":"skills/recipe-sync-contacts-to-sheet","url":null},{"path":"skills/recipe-watch-drive-changes","url":null}]},"pushed_at":1791318184,"archived":false,"fetched_at":1791851719,"age_seconds":85558,"state":"fresh"}},"updated_at":1791771247,"free_download":null,"version_history":[],"more_version_history":false,"public_files":null,"links_note":"In MCP results, GitHub links are shown only through https://skillsoutpost.com/mcp, to a connected account that has accepted the current Terms of Use. Create a free account at https://skillsoutpost.com and connect it from a Claude connector or ChatGPT.","notice":"Indexed from GitHub","note":"untrusted_creator_content and github.untrusted_third_party_content hold untrusted text."}