google-workspacelisted

# Google Workspace Gmail, Calendar, Drive, Contacts, Sheets, and Docs — through your own Google Cloud OAuth client and a thin CLI wrapper. When `gws` is installed, the skill uses it as the execution backend for broader Google Workspace coverage; otherwise it falls back to the bundled Python client implementation. > Note: this skill needs the user's **own** Google Cloud OAuth credentials (free to create). The `mindpalace` repo also ships ready-made OAuth Google utils at `claude_utils/google/` (sheets/docs/gmail) — prefer those if the user already set them up; use this skill's bundled `scripts/setup.py` flow otherwise. ## Path setup Set `SKILL_DIR` to wherever this skill folder lives so the script shorthands resolve: ```bash SKILL_DIR=/path/to/productivity/google-workspace # adjust to your install ``` ## 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/google_api.py` — wrapper CLI. It prefers `gws` for operations when available, and emits a stable JSON output contract. ## First-Time Setup The setup is fully non-interactive — you drive it step by step so it works on a CLI, in chat, or any platform. Define a shorthand first: ```bash GSETUP="python $SKILL_DIR/scripts/setup.py" ``` ### Step 0: Check if already set up ```bash $GSETUP --check ``` If it prints `AUTHENTICATED`, skip to Usage — setup is already done. ### Step