About this project

gws is a command-line tool designed for both humans and AI agents to interact with Google Workspace APIs. Unlike static CLIs, it reads the Google Discovery Service at runtime, meaning it automatically supports new API endpoints and methods as they are released by Google. Key capabilities include: - Broad Service Support: Provides access to Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin, and more. - AI Agent Integration: Outputs structured JSON and includes over 100 predefined agent skills and recipes for LLM integration. - Human-Centric Features: Includes built-in help for every resource, dry-run previews, and automatic pagination. - Helper Commands: Offers specialized shortcuts (prefixed with `+`) for common tasks like sending emails (`+send`), reading spreadsheets (`+read`), and generating standup reports (`+standup-report`). - Flexible Authentication: Supports multiple workflows including interactive OAuth, service accounts, and pre-obtained access tokens. - Security Integration: Integrates with Google Cloud Model Armor to sanitize API responses for prompt injection. The tool is written in Rust and can be installed via pre-built binaries, npm, Homebrew, or Nix.