A powerful Google Calendar integration that allows users to manage their schedules through natural conversation and automated morning briefs.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install gcal-pro-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 gcal-pro-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 gcal-pro?
gcal-pro is a sophisticated integration designed to bridge the gap between AI agents and Google Calendar. By leveraging this tool within the ecosystem of Openclaw Skills, users can query their schedules, check availability, and manage events using simple, human-like commands. It offers a tiered approach, providing comprehensive read access for free and unlocking advanced write capabilities and automation features for pro users.
The skill is built to be highly conversational, allowing users to ask questions like "What's on my calendar tomorrow?" or "When am I free?" without needing to navigate complex UI menus. It prioritizes user privacy and security through local OAuth credential management and clear confirmation prompts for destructive actions.
gcal-pro Use Cases
- Checking daily or weekly schedules through natural language queries.
- Finding free time slots for meetings without manual searching.
- Receiving automated morning briefs to start the day organized.
- Quickly adding events like "Lunch Friday noon" without opening a browser.
- Managing multiple calendars and searching for specific past or future events.
How gcal-pro Works
- The user provides a natural language command or trigger to the AI agent.
- The agent invokes the gcal-pro core script with relevant parameters such as search queries or time ranges.
- The skill interacts with the Google Calendar API using pre-configured OAuth credentials and local tokens.
- Results are parsed and formatted into a human-readable layout, including emojis and clear timestamps.
- For Pro users, the skill can perform actions like rescheduling or deleting events after confirming with the user.
gcal-pro Setup
To get started with gcal-pro and enhance your Openclaw Skills library, follow these steps:
- Create a Google Cloud project and enable the Google Calendar API.
- Download your OAuth credentials and save the
client_secret.jsonfile to~/.config/gcal-pro/. - Run the authentication script to link your account:
python scripts/gcal_auth.py auth
- Follow the browser prompt to grant access and generate your local token.
- Verify your authentication status:
python scripts/gcal_auth.py status
gcal-pro Data Schema & Taxonomy
The skill maintains configuration and session data locally to ensure seamless interaction with Openclaw Skills. Data is organized as follows:
| File | Description | Location |
|---|---|---|
client_secret.json |
Google OAuth app credentials provided by the user | ~/.config/gcal-pro/ |
token.json |
User access and refresh tokens generated after auth | ~/.config/gcal-pro/ |
license.json |
Pro tier license verification file | ~/.config/gcal-pro/ |
gcal-pro Advanced Features
- Natural Language Processing: Use the Quick add feature to interpret phrases like "Lunch with Alex at noon Friday" into structured calendar data.
- Automated Briefings: Integrate with cron jobs to generate and deliver Morning Briefs via your preferred messaging channels.
- Multi-Agent Support: Designed to work across different messaging platforms when combined with Clawdbot memory and messaging hooks.
- Smart Timezone Handling: Automatically detects and honors user-specific timezones for all event interactions and displays.
- Pro Tier Capabilities: Unlocks full CRUD (Create, Read, Update, Delete) operations and automated scheduling triggers.
SKILL.md
Loading
Related Openclaw Skills
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.
MiniMax CLI Web Search
A high-performance CLI-driven web search skill utilizing MiniMax MCP and mcporter for real-time research and data retrieval.
gcal-pro
A comprehensive Google Calendar integration for AI agents to view, create, and manage schedule events using natural language.
BlackSwan Risk Intelligence
A real-time crypto risk intelligence toolset that provides precursor detection and market state synthesis via two specialized agents.
Featured*
