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
Install
kv0906/pm-kit/gws · repository language: Python
git clone https://github.com/kv0906/pm-kit
cp -r pm-kit/.claude/skills/gws ~/.claude/skills/gwsFrequently 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)
Read as markdown · JSON record · Browse the source repository
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