google-workspace

name	Google Workspace
description	Access Google Calendar, Gmail, and Google Docs/Drive using gws-auth CLI. Download Google Docs, manage calendar events, and send emails.

Google Workspace Integration

Use the gws-auth CLI to interact with Google Calendar, Gmail, and Google Drive/Docs.

Google Docs Operations

Downloading Google Docs

To download a Google Doc as text:

~/.openclaw/skills/google-workspace/download-google-doc "DOCUMENT_URL_OR_ID"

Examples:

# Full URL
~/.openclaw/skills/google-workspace/download-google-doc "https://docs.google.com/document/d/1aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789_example/edit"

# Just the document ID
~/.openclaw/skills/google-workspace/download-google-doc "1aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789_example"

When to use:

• User shares a Google Docs link and asks you to process it
• User asks you to download or read a Google Doc
• User wants meeting notes from a Google Doc processed

Important: You CAN access Google Docs. Do NOT say you cannot access them.

Phone-to-email mappings are loaded from config.yaml. See config.example.yaml for format.

Creating Calendar Events

IMPORTANT: The assistant has READ-ONLY access to team calendars. When creating events, create them on the assistant's calendar and invite the requesting user.

Use the helper script which handles Israel timezone (Asia/Jerusalem) automatically, including DST transitions:

~/.openclaw/skills/google-workspace/create-calendar-event <phone> <title_words...> <date> <time> [duration_minutes]

Example: Create "Pick up kids from school" event:

~/.openclaw/skills/google-workspace/create-calendar-event [phone] Pick up kids from school 2026-02-08 12:45 30

• Default duration: 30 minutes if not specified
• The script resolves the phone number to an email and adds them as attendee
• Timezone offset is computed automatically from Asia/Jerusalem (handles IST/IDT)

Important Notes:

1. Always use the create-calendar-event script — do not manually construct timezone offsets
2. If time is ambiguous, ask the user for clarification

Gmail Operations

Send email:

gws-auth gmail +send --to [e-mail] --subject "Subject" --body "Message body"

Search threads:

gws-auth gmail users threads list --params '{"userId":"me","q":"from:[e-mail]","maxResults":5}'

Authentication

All commands use the assistant account credentials configured via gws-auth auth login. Credentials are stored in ~/.config/gws/.