gws
gws is a Rust-based CLI tool that wraps Google Workspace APIs into composable commands with structured JSON responses, dynamically syncing with Google's Discovery Service for always-current API support. Install via npm, authenticate with gws auth setup, and access Gmail, Drive, Calendar, Sheets, Docs, Chat, Meet, and Forms through simple command patterns or helper shortcuts. Includes an MCP server for deeper Claude Code integration and sanitization options to prevent prompt injection from API responses.
gws sets up Google Workspace CLI authentication and command-line access to Gmail, Drive, Calendar, Sheets, Docs, and other Google services.
AI-generated summary based on this skill's SKILL.md
Decision gist · record as of 2026-06-29
gws sets up Google Workspace CLI authentication and command-line access to Gmail, Drive, Calendar, Sheets, Docs, and other Google services. gws is a Rust-based CLI tool that wraps Google Workspace APIs into composable commands with structured JSON responses, dynamically syncing with Google's Discovery Service for always-current API support. Install via npm, authenticate with gws auth setup, and access Gmail, Drive, Calendar, Sheets, Docs, Chat, Meet, and Forms through simple command patterns or helper shortcuts. Includes an MCP server for deeper Claude Code integration and sanitization options to prevent prompt injection from API responses.
Use it when
- Yes.
- gws CLI lets you upload files to Google Drive and manage your Drive content via command line.
Verify before relying
Read SKILL.md below before installing (4 files). Open directory: indexed for reading, not audited.
Install
kv0906/pm-kit/gws · repository language: Python
Open directory. Skills are indexed for reading, not audited. Review a skill's body before installing it.
Frequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How do I set up Google Workspace CLI with gws?
gws is a Rust-based CLI tool installed via npm that connects Claude to Google Workspace services. Install it with `npm install -g gws`, then run `gws auth setup` to authenticate. This opens a browser flow to grant gws access to your Google account. Once authenticated, gws syncs dynamically with Google's Discovery Service, keeping all API support current without manual updates.
Can I connect Gmail to Claude with gws and read messages?
Yes. gws provides command patterns to access Gmail through the CLI. After authentication with `gws auth setup`, you can use gws to read Gmail messages and execute other Gmail operations. All responses return structured JSON, making it easy for Claude agents to parse and act on email data programmatically from the terminal.
How do I manage Google Drive from terminal using gws?
gws CLI lets you upload files to Google Drive and manage your Drive content via command line. After running `gws auth setup`, use gws commands to interact with Drive. The tool returns structured JSON responses, so you can automate file operations, list contents, and integrate Drive workflows directly into Claude Code or terminal scripts.
What Google Workspace services does gws support for automation?
gws supports Gmail, Drive, Calendar, Sheets, Docs, Chat, Meet, and Forms. You can automate workflows across all these services—send emails, create calendar events, generate documents, manage spreadsheets, and send Chat messages—all from the terminal with structured JSON output. The tool also includes an MCP server for deeper integration with Claude Code.
How do I integrate gws MCP server with Claude Code?
gws includes an MCP server for advanced Claude Code integration. Set up the MCP server connection in your Claude environment, then use gws commands within Claude Code for multi-service tasks. This enables Claude to orchestrate complex Google Workspace workflows—combining Gmail, Drive, Calendar, and other services—with full access to structured API responses.
What should I do if gws installation or OAuth setup fails?
gws is MIT-licensed and troubleshooting typically involves verifying npm installation, checking OAuth credentials, and ensuring your Google account has the required permissions. If `gws auth setup` fails, confirm your browser can reach Google's login page and that you're granting all requested scopes. Consult gws documentation for detailed error messages and recovery steps.
SKILL.md
Rendered from the published skill. Quoted content, verbatim.
Google Workspace CLI (gws)
A CLI tool built in Rust that wraps every Google Workspace API into composable commands with structured JSON output. It dynamically builds its command structure from Google's Discovery Service, so it always supports the latest APIs without updates.
Prerequisites
- gcloud CLI: Required for authentication. Install via
brew install --cask google-cloud-sdkon macOS. - Node.js/npm: Required to install gws.
Installation & Setup
# 1. Install the CLI
npm install -g @googleworkspace/cli
# 2. Set up auth (interactive walkthrough for GCP project + OAuth)
gws auth setup
# 3. Login to Google Workspace account
gws auth login
The gws auth setup command walks through:
1.
(truncated - see the full file via the links below)
File tree — 4 files
.claude/skills/gws/SKILL.md
.claude/skills/gws/references/services.md
.claude/skills/gws/references/setup-troubleshooting.md
.claude/skills/gws/scripts/check-gws.sh
Let your AI agent find skills like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 56,283 agent skills by what they can do, searchable in plain language.
wish › “Set up and authenticate Google Workspace CLI for Claude agent access”
Give your agent the search over MCP, or paste the wish link into any chat. No install? Search from any chat →
Related skills
A single command-line interface that connects to every Google Workspace API, from Drive and Gmail to Calendar, Sheets, Docs, Slides, Chat, and Admin tools. The CLI dynamically discovers available endpoints at runtime, so new Google APIs are supported automatically without updates. Built for both human operators and AI agents with JSON-structured output.
Gws is a command-line interface for Google Workspace that streamlines email triage, calendar management, file uploads, spreadsheet operations, and task creation. It supports helper commands for common workflows like standup reports and meeting prep, plus raw API access for advanced use cases. Built for both interactive queries and scripted automation.
Google Drive integrates Drive v3 API operations—search, list, upload, download, copy, move, share, and permission management—through the gws CLI. Requires gws authenticated against a Google account with appropriate Drive scopes. Use this skill to locate files, manage folders and shared drives, adjust sharing settings, or pull file metadata into other workflows.
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.
This recipe automates setup of repeating calendar meetings in Google Calendar, adding attendees and configuring recurrence rules in a single operation. It builds on the gws-calendar skill to handle the full workflow.
This recipe automates the setup of recurring focus time blocks on Google Calendar, marking them as busy to shield your deep work from interruptions. It uses the gws-calendar skill to establish weekly blocks across weekdays.
More skills google-meet (MIT) · Google Workspace (Apache-2.0) · google-workspace (MIT) · recipe-create-events-from-sheet (Apache-2.0) · gws-calendar-insert (Apache-2.0) · gws-setup (MIT)