How do I install the Google Workspace skill?

Run npx skillmds@latest add tomevault-io/google-workspace-5 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Google Workspace safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Google Workspace?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Google Workspace free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Google Workspace?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Google Workspace by tomevault-io — Agent Skill

Name: Google Workspace
Author: tomevault-io

File contents

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 +1234567890 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:

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

Gmail Operations

Send email:

gws-auth gmail +send --to user@example.com --subject "Subject" --body "Message body"

Search threads:

gws-auth gmail users threads list --params '{"userId":"me","q":"from:user@example.com","maxResults":5}'

Authentication

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

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: google-workspace-5description: Access Google Calendar, Gmail, and Google Docs/Drive using gws-auth CLI. Download Google Docs, manage calendar events, and send emails. Use when this capability is needed.---# Google Workspace IntegrationUse the `gws-auth` CLI to interact with Google Calendar, Gmail, and Google Drive/Docs.## Google Docs Operations### Downloading Google DocsTo download a Google Doc as text:```bash~/.openclaw/skills/google-workspace/download-google-doc "DOCUMENT_URL_OR_ID"```**Examples:**```bash# 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:```bash~/.openclaw/skills/google-workspace/create-calendar-event <phone> <title_words...> <date> <time> [duration_minutes]```**Example: Create "Pick up kids from school" event:**```bash~/.openclaw/skills/google-workspace/create-calendar-event +1234567890 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 offsets2. **If time is ambiguous**, ask the user for clarification## Gmail Operations### Send email:```bashgws-auth gmail +send --to user@example.com --subject "Subject" --body "Message body"```### Search threads:```bashgws-auth gmail users threads list --params '{"userId":"me","q":"from:user@example.com","maxResults":5}'```## AuthenticationAll commands use the assistant account credentials configured via `gws-auth auth login`.Credentials are stored in `~/.config/gws/`.---> Converted and distributed by [TomeVault](https://tomevault.io/claim/navotvolkgroundup) — claim your Tome and manage your conversions.

Frequently asked questions

Google Workspace