What problem does it solve?
Centralizes and automates access to Google Workspace services so an agent can perform email triage, calendar management, file search, contacts lookup, spreadsheet reads/updates, and document retrieval without manual OAuth juggling.
Core Features & Use Cases
- Unified CLI wrapper: A backward-compatible Python wrapper delegates to the gws CLI to provide consistent commands across Gmail, Calendar, Drive, Contacts, Sheets, and Docs.
- Non-interactive OAuth and token refresh: Setup and bridge scripts handle client secret storage, authorization URL generation, token exchange, automatic refresh, and revocation for profile-scoped tokens.
- Practical scenarios: Use it to triage unread messages, create or delete calendar events with timezone-aware ISO timestamps, search Drive for reports, or read and append Sheets programmatically.
Quick Start
Run the setup script to store your OAuth client credentials, obtain the authorization URL, paste back the authorization code, and then use the provided API wrapper to run Gmail, Calendar, Drive, Contacts, Sheets, and Docs commands.