google-workspace

# Google Workspace Gmail, Calendar, Drive, Contacts, Sheets, and Docs — all through Python scripts in this skill. No external binaries to 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` — API wrapper CLI (agent uses this for all operations) ## 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 GSETUP="python ~/.hermes/skills/productivity/google-workspace/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 1: Triage — ask the user what they need Before starting OAuth setup, ask the user TWO questions: **Question 1: "What Google services do you need? Just email, or also Calendar/Drive/Sheets/Docs?"** - **Email only** → They don't need this skill at all. Use the `himalaya` skill instead — it works with a Gmail App Password (Settings → Security → App Passwords) and takes 2 minutes to set up. No Google Cloud project needed. Load the himalaya skill and follow its setup instructions. - **Calendar, Drive, Sheets, Docs (or email + these)** → Continue with this skill's OAuth setup below. **Question 2: "Does your Google account use Advanced Protection (hardware sec...