A comprehensive Google Calendar integration for AI agents to view, create, and manage schedule events using natural language.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install gcal-pro
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 gcal-pro 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 gcal-pro?
gcal-pro is a professional-grade tool designed for the Openclaw Skills ecosystem that bridges the gap between AI agents and Google Calendar. It allows users to interact with their schedules using conversational commands, making it easier than ever to check availability or organize meetings. Whether you need a simple read-only view of your day or full administrative control over your appointments, this skill provides a robust framework for calendar management.
By integrating gcal-pro into your workflow, you leverage one of the essential Openclaw Skills that supports both manual CLI interactions and automated background tasks. The skill is split into a capable Free tier for schedule visibility and a Pro tier for high-intensity users who need to create, edit, or delete events and receive automated morning briefings.
gcal-pro Use Cases
- Checking daily agendas and upcoming weekly meetings using natural language queries.
- Identifying gaps in a busy schedule to find the best time for new appointments.
- Automating daily morning briefs to stay updated on tasks before the workday starts.
- Rapidly adding new events like "Lunch with Alex Friday at noon" without opening a browser.
- Managing multiple Google Calendars through a single AI-driven interface.
How gcal-pro Works
- The agent initializes a connection using OAuth 2.0 credentials stored in the local configuration directory.
- When a user provides a natural language prompt, the skill parses the intent into specific calendar actions.
- For read operations, the skill queries the Google Calendar API and returns a formatted list of events or free time slots.
- For write operations (Pro tier), the skill processes the request, often requiring a confirmation step to ensure accuracy.
- Automation hooks allow for scheduled tasks, such as generating morning briefs via cron jobs.
gcal-pro Setup
To get started with this addition to your Openclaw Skills library, follow these steps:
- Create a Google Cloud project and generate OAuth credentials.
- Save your
client_secret.jsonto~/.config/gcal-pro/. - Authenticate the skill by running:
python scripts/gcal_auth.py auth
- Verify your status:
python scripts/gcal_auth.py status
gcal-pro Data Schema & Taxonomy
The skill manages data locally within the ~/.config/gcal-pro/ directory to ensure security and persistence. The structure is as follows:
| File | Description |
|---|---|
client_secret.json |
OAuth application credentials provided by the user. |
token.json |
Automatically generated access and refresh tokens. |
license.json |
Stores the Pro tier license key for premium features. |
All event data is processed in ISO 8601 format, ensuring accurate timezone handling across different regions.
gcal-pro Advanced Features
- Natural language event creation via the Quick Add feature for Pro users.
- Automated morning briefs that summarize the day's agenda using Clawdbot cron integration.
- Multi-calendar support to list and view events across all shared Google Calendars.
- Intelligent free-time discovery to suggest meeting slots based on current availability.
- Native integration with messaging channels like Telegram or WhatsApp via Openclaw Skills hooks.
SKILL.md
Loading
Related Openclaw Skills
gcal-pro
A powerful Google Calendar integration that allows users to manage their schedules through natural conversation and automated morning briefs.
Meta Marketing CLI
A robust command-line interface for managing the Meta Marketing API, Instagram publishing, and advertising insights with strict fail-closed reliability.
Tesla Control
A comprehensive Python-based interface to monitor and control Tesla vehicles using the Tessie API.
OpenClaw Updater
A specialized utility for safely updating the OpenClaw platform with automated safety checks, state backups, and one-click rollback support.
BlackSwan Risk Intelligence
A real-time crypto risk intelligence toolset that provides precursor detection and market state synthesis via two specialized agents.
Discord Markdown Formatter
A specialized tool for generating copy-paste ready Discord messages with full markdown support, syntax highlighting, and metadata validation.
Featured*
