google-workspace

# Google Workspace Gmail, Calendar, Drive, Contacts, Sheets, and Docs — powered by `gws` (Google's official Rust CLI). The skill provides a backward-compatible Python wrapper that handles OAuth token refresh and delegates to `gws`. ## Architecture ``` google_api.py → gws_bridge.py → gws CLI (argparse compat) (token refresh) (Google APIs) ``` - `setup.py` handles OAuth2 (headless-compatible, works on CLI/Telegram/Discord) - `gws_bridge.py` refreshes the Hermes token and injects it into `gws` via `GOOGLE_WORKSPACE_CLI_TOKEN` - `google_api.py` provides the same CLI interface as v1 but delegates to `gws` ## References - `references/gmail-search-syntax.md` — Gmail search operators (is:unread, from:, newer_than:, etc.) ## Scripts - `scripts/setup.py` — OAuth2 setup (run once to authorize) - `scripts/gws_bridge.py` — Token refresh bridge to gws CLI - `scripts/google_api.py` — Backward-compatible API wrapper (delegates to gws) ## Prerequisites Install `gws`: ```bash cargo install google-workspace-cli # or via npm (recommended, downloads prebuilt binary): npm install -g @googleworkspace/cli # or via Homebrew: brew install googleworkspace-cli ``` Verify: `gws --version` ## First-Time Setup The setup is fully non-interactive — you drive it step by step so it works on CLI, Telegram, Discord, or any platform. Define a shorthand first: ```bash HERMES_HOME="${HERMES_HOME:-$HOME/.hermes}" GWORKSPACE_SKILL_DIR="$HERMES_HOME/skills/productivity/google-workspace" PYTHON_...