A high-performance interface for managing Google Calendar through the gcalcli command-line tool, optimized for speed and minimal token usage.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install gcalcli-calendar
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install gcalcli-calendar using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is gcalcli-calendar?
This skill leverages the gcalcli utility to provide a streamlined, non-interactive way for AI agents to interact with Google Calendar. It prioritizes deterministic agenda scans over expensive searches, ensuring high accuracy and low latency. By following strict CLI flag placement and using optimized subcommands, it enables reliable event management without the overhead of heavy graphical interfaces or complex API wrappers.
This implementation is part of the broader Openclaw Skills ecosystem, designed to make personal scheduling both fast and friction-free. It focuses on meaning-first lookups and automated verification to ensure that every calendar modification is reflected accurately in the cloud.
gcalcli-calendar Use Cases
- Fetching the daily agenda for a today at a glance summary.
- Finding specific events based on semantic meaning (e.g., "my next train") across a 30-day window.
- Automatically checking for schedule overlaps across all calendars before creating new appointments.
- Managing recurring events or free/busy transparency settings via direct ICS pipe-in.
- Deleting or canceling appointments with built-in verification loops to ensure success.
How gcalcli-calendar Works
- The skill identifies the user intent, such as viewing an agenda, searching for a specific event, or creating a new entry.
- For lookups, it performs a bounded agenda scan (meaning-first) to locate events based on time windows and semantic context.
- If creating an event, it executes a cross-calendar overlap preflight check to detect potential conflicts.
- It executes the appropriate gcalcli command, ensuring global and subcommand-specific flags are correctly positioned for non-interactive execution.
- For critical actions like deletion, it performs a post-action verification scan and retries with a refresh if the event still appears.
gcalcli-calendar Setup
Ensure that gcalcli is installed and authenticated on your system. The skill relies on the binary being available in the PATH.
# Install gcalcli via pip
pip install gcalcli
# Perform initial authentication
gcalcli list
Configure your default calendars in the gcalcli configuration file to ensure the skill targets the correct data by default.
gcalcli-calendar Data Schema & Taxonomy
The skill organizes calendar data using standard Google Calendar attributes processed through gcalcli.
| Attribute | Description |
|---|---|
| Event Title | The summary or name of the calendar entry. |
| Time Window | ISO or human-friendly start and end points. |
| Duration | Event length in minutes for timed events. |
| RRULE | Recurrence rules for repeating events (handled via ICS import). |
| TRANSP | Transparency (OPAQUE for busy, TRANSPARENT for free). |
| Reminders | Notification triggers (popup, email, sms) with specific time offsets. |
gcalcli-calendar Advanced Features
- Meaning-first semantic matching: Locates events by intent rather than just exact string matches, scanning up to 180 days.
- Cross-calendar overlap detection: Prevents double-booking by checking all non-ignored calendars regardless of the target calendar.
- Non-interactive editing: Employs a delete-and-recreate workflow to modify properties that are not editable in-place via CLI.
- Direct ICS piping: Supports advanced event properties like recurring schedules and transparency without requiring temporary files.
- Automatic weekday resolution: Scans a 14-day window to resolve requests like "on Monday" without manual date calculation.
SKILL.md
Loading
Related Openclaw Skills
Daily Briefing Skill
An automated summary tool that synthesizes calendar events, active tasks, and weather forecasts into a mobile-optimized daily briefing.
Social Media Multi-Platform Publisher
A browser automation skill for multi-platform social media content publishing and draft management.
SerpAPI Search
A powerful search integration for AI agents to fetch real-time web results across multiple engines via SerpAPI.
Finnhub Pro
A professional Python CLI tool providing instant access to real-time US stock market data, company fundamentals, and insider trading activity.
Gog Advanced (Google Workspace CLI)
A high-reliability CLI tool for AI agents to interact with Google Workspace services like Gmail, Calendar, and Drive using JSON-first outputs.
gog-calendar
A powerful Google Calendar integration for AI agents utilizing gogcli for robust cross-calendar agenda management and intelligent event searching.
METADATA
Featured*
