---
created: 2026-03-12
tags: [infrastructure, google, integration]
related: ["[[08-Infrastructure/Infrastructure Map]]", "[[07-Command-Centre/Operations Architecture]]"]
---

# Google Integration

## What's Installed

**Google Workspace CLI (gws)** v0.11.1
- Published: 2026-03-10 by Google (`@googleworkspace/cli`)
- Binary: `gws` (installed globally via npm)
- Path: `C:\Users\mclou\AppData\Roaming\npm\gws`
- Config: `C:\Users\mclou\.config\gws\`

## Accessible Services

| Service | Scope | Status |
|---|---|---|
| Gmail | `gmail.modify` (read/send/modify) | Verified |
| Google Drive | `drive` (full access) | Verified |
| Google Calendar | `calendar` (full access) | Verified |
| Google Sheets | `spreadsheets` (full access) | Verified |
| Google Docs | `documents` (full access) | Verified |
| Google Tasks | `tasks` (full access) | Verified |

## Authentication

- **Method:** OAuth2 (personal account)
- **Account:** `admin@rateright.com.au`
- **GCP Project:** `rateright-mvp` (project ID: 414188553078)
- **OAuth Client:** Desktop app (`gws CLI`)
- **Consent Screen:** Internal (rateright.com.au org — no verification needed)
- **Credentials:** AES-256-GCM encrypted at `~/.config/gws/credentials.enc` (key in OS keyring)

## Usage Examples

```bash
# Gmail — list recent messages
gws gmail users messages list --params '{"userId":"me","maxResults":5}' --format table

# Calendar — list upcoming events
gws calendar events list --params '{"calendarId":"primary","maxResults":5}' --format table

# Drive — list files
gws drive files list --params '{"pageSize":5}' --format table

# Sheets — read a spreadsheet
gws sheets spreadsheets get --params '{"spreadsheetId":"SHEET_ID"}'

# Docs — get a document
gws docs documents get --params '{"documentId":"DOC_ID"}'

# Tasks — list task lists
gws tasks tasklists list --format table
```

## Status Per Layer

| Layer | Tool | Status | Notes |
|---|---|---|---|
| **Cowork** (Desktop) | Gmail/Calendar/Drive via MCP connectors | Connected | Separate auth |
| **CC Local** (PowerShell) | `gws` CLI v0.11.1 | **Installed & verified** | OAuth as admin@rateright.com.au |
| **CC VPS** | Pending | Not installed | Needs service account for headless auth (no browser on VPS) |
| **Fleet/OpenClaw** | Pending | Not configured | Native Google integration available in OpenClaw |

## Next Steps

- [ ] Install `gws` on VPS with service account auth (headless — use `GOOGLE_WORKSPACE_CLI_KEYRING_BACKEND=file`)
- [ ] Configure OpenClaw Google skills for fleet agents
- [ ] Set up Google Drive folder structure for vault backups
- [ ] Consider Google Sheets as live dashboard data source

## GCP Project Info

- **Project:** rateright-mvp
- **Org:** rateright.com.au (ID: 12515521909)
- **Billing:** Enabled (account `01E036-9E6FF2-53C7A1`)
- **APIs enabled:** Drive, Sheets, Calendar, Gmail, Docs, Tasks + others