# Gcal Ro

> Read-only Google Calendar access for OpenClaw via gogcli (today/tomorrow/next days/search). Use when this capability is needed.

- Skill: `tomevault-io/gcal-ro` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/gcal-ro`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/gcal-ro/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/gcal-ro

---


Use this skill when the user asks:
- “What’s on my calendar today/tomorrow?”
- “What are my next meetings?”
- “When is <thing>?” / “Do I have <thing> on my calendar?”

## READ-ONLY policy

This skill is read-only.
- DO NOT create/update/delete events.
- DO NOT respond to invitations.
- Only use the wrapper commands below.

## How to call Calendar

Use the `exec` tool to run these commands:

- Today’s events:
  - `/home/algal/ws-sparky/skills/gcal-ro/bin/gcal-ro today 15`

- Tomorrow’s events:
  - `/home/algal/ws-sparky/skills/gcal-ro/bin/gcal-ro tomorrow 15`

- Next N days (default 7):
  - `/home/algal/ws-sparky/skills/gcal-ro/bin/gcal-ro days 7 30`

- Search (free text) within next 30 days:
  - `/home/algal/ws-sparky/skills/gcal-ro/bin/gcal-ro search "<query>" 30 20`

## Required environment (non-interactive)

The OpenClaw service should have:
- `GOG_KEYRING_BACKEND=file`
- `GOG_KEYRING_PASSWORD=...`
- `GOG_ACCOUNT=you@gmail.com`

Optional:
- `GCAL_ID=primary` (or a specific calendar ID)

## Output handling

The wrapper returns JSON from `gog ... --json`.
Summarize for the user:
- chronological list
- include start time (local), title, and location (if present)
- if there are no events, say so

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/algal) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->