Google Workspace Skill

Overview

Unified Google Workspace integration for managing email, calendar, files, and communication across three accounts:

Account Selection

Explicit

• "check my psd email"
• "send email from hrg"
• "kh calendar for tomorrow"

Inferred

Geoffrey will infer the appropriate account from context:

• Work-related → psd
• Personal matters → kh
• Business/real estate → hrg

Available Operations

Gmail

Calendar

Drive

Tasks

Chat

Usage Patterns

Running Scripts

All scripts use the token_manager for authentication:

const { getAuthClient } = require('./auth/token_manager');

async function main() {
  const account = process.argv[2] || 'psd';
  const auth = await getAuthClient(account);

  // Use auth with Google API
  const gmail = google.gmail({ version: 'v1', auth });
  // ...
}

Output Format

All scripts return JSON:

{
  "success": true,
  "account": "psd",
  "data": { ... },
  "metadata": {
    "timestamp": "2024-01-15T10:30:00Z",
    "count": 5
  }
}

Error Handling

{
  "error": "Token expired",
  "account": "psd",
  "action": "Run: node token_manager.js refresh psd"
}

Setup Required

Before using this skill:

1. Complete Google Cloud Console setup (see auth/GOOGLECLOUDSETUP.md)
2. Add credentials to ~/Library/Mobile Documents/com~apple~CloudDocs/Geoffrey/secrets/.env
3. Authenticate all three accounts
4. For PSD account: allowlist OAuth app in Google Admin

Cross-Account Operations

Some operations work across accounts:

• "Forward this to my personal email"
• "Copy this file to my work drive"
• "Add to both calendars"

Gmail Search Operators

Support standard Gmail search:

• from: - sender
• to: - recipient
• subject: - subject line
• has:attachment - with attachments
• after: / before: - date range
• is:unread - unread only
• label: - by label

Example: "search psd email for from:[email protected] after:2024-01-01 has:attachment"

Notes

• Access tokens expire after 1 hour (auto-refreshed)
• Refresh tokens don't expire unless revoked
• All API calls are rate-limited by Google
• Keep API has limited availability (may not be enabled)