A powerful skill for AI agents to interact with Google Calendar accounts, enabling seamless event management and scheduling through a unified CLI.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install google-calendar-master
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 google-calendar-master 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 Google Calendar?
The Google Calendar skill provides a robust interface for AI coding agents to interact with the Google Calendar API. It enables the creation, retrieval, updating, and deletion of events across multiple accounts. By leveraging Openclaw Skills, developers can automate appointment scheduling, agenda queries, and availability checks without leaving their terminal or agent environment.
This skill is designed to handle complex scenarios like multi-account management (e.g., separating work and personal schedules) and context-aware event creation. It uses OAuth2 for secure authentication and provides a standardized command set that simplifies interaction with the often complex Google API surface.
Google Calendar Use Cases
- Automating the creation of recurring team standups or meetings.
- Querying daily agendas and checking for scheduling conflicts across multiple accounts.
- Inviting attendees and managing guest lists for calendar events.
- Quick-adding appointments using natural language descriptions via AI agents.
- Synchronizing schedules by fetching free/busy status for specific time ranges.
How Google Calendar Works
- The AI agent navigates to the skill's scripts directory to execute operations.
- Authentication is verified using stored OAuth tokens; if expired, the skill attempts an automatic refresh.
- For listing or updating, the skill iterates through all labeled accounts to provide a comprehensive view of the user's availability.
- For event creation, the skill references a local config file to select the correct account based on the user's intent or the account's stated purpose.
- Commands are executed via Bun, interacting directly with the Google Calendar REST API and returning labeled results to the agent.
Google Calendar Setup
Follow these steps to integrate the Google Calendar skill into your Openclaw Skills environment:
- Ensure
~/.config/google-calendar-skill/client.jsoncontains your Google API credentials. - Run the authentication flow:
bun run auth.ts login
- Label the account for context (e.g., 'work' or 'personal'):
bun run auth.ts label <chosen-name> [purpose]
- Verify your connected calendars:
bun run calendar.ts calendars
Google Calendar Data Schema & Taxonomy
The skill manages its state and metadata through a specific file structure and JSON taxonomy:
| Component | Description |
|---|---|
config.json |
Stores account labels and their associated purposes (e.g., 'Work meetings'). |
client.json |
Located in ~/.config/google-calendar-skill/, stores API secrets. |
scripts/ |
Contains the TypeScript logic for auth and calendar operations. |
Example config.json schema:
{
"accounts": {
"work": { "purpose": "Work meetings, standups" },
"personal": { "purpose": "Family events" }
}
}
Google Calendar Advanced Features
- Multi-account support with purpose-based routing for intelligent account selection.
- Automatic token refreshing to ensure uninterrupted agent operations.
- Granular attendee management including batch addition, removal, and notification suppression.
- Free/busy status querying to check availability across multiple synchronized schedules.
- Support for both timed and all-day events with flexible JS-parsable date formats.
SKILL.md
Loading
Related Openclaw Skills
Google Calendar Skill
A comprehensive automation skill that enables AI agents to manage Google Calendar events, query availability, and handle multiple accounts through a streamlined CLI interface.
Miniflux
A powerful CLI-based tool for AI agents to interact with Miniflux RSS feeds, allowing for article discovery, reading, and management.
Delete Agent with Telegram Group
A safety-first skill designed to permanently delete OpenClaw agents, including their workspaces, local configurations, and associated Telegram group routings.
Create Agent with Telegram Group
An automated provisioning tool for creating dedicated AI agents with isolated workspaces and bound Telegram groups.
macOS Reminders Skill
An AI-driven interface for managing native macOS Reminders through simple CLI commands and JSON responses.
DuckDuckGo CLI (ddgr)
A lightweight, privacy-focused command-line utility for performing DuckDuckGo searches directly from your terminal or AI agent environment.
Featured*
