A programmatic wrapper for the Google Calendar API allowing agents to manage schedules, events, and appointments via command-line interface.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install google-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 google-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 Google Calendar Skill?
The Google Calendar skill provides a robust interface for interacting with the Google Calendar REST API directly through an automated environment. Built as a Python-based utility, it enables developers to perform full CRUD (Create, Read, Update, Delete) operations on calendar events, including listing upcoming meetings, scheduling new appointments, and modifying existing entries using standard ISO formats.
This integration bridges the gap between automated workflows and personal or team scheduling, making it a vital addition to any suite of Openclaw Skills. It handles OAuth 2.0 authentication securely using refresh tokens, ensuring that your calendar data remains protected while accessible for headless automation or command-line task management.
Google Calendar Skill Use Cases
- Automating meeting scheduling based on AI agent task outcomes.
- Fetching daily agendas to provide context for productivity agents.
- Synchronizing external task lists or project milestones with a primary Google Calendar.
- Modifying event details, locations, or attendee lists programmatically across multiple calendars.
How Google Calendar Skill Works
- The skill initializes by loading Google API credentials and a persistent refresh token from the environment configuration.
- It performs an OAuth 2.0 handshake to obtain a temporary access token for secure API communication.
- The skill translates CLI commands (such as list, add, update, or delete) into specific Google Calendar API v3 REST requests.
- The service execution layer processes the request and returns a standardized JSON payload to stdout for the calling agent to consume.
Google Calendar Skill Setup
- Create a project in the Google Cloud Console and enable the Google Calendar API.
- Generate OAuth Desktop credentials to obtain a Client ID and Client Secret.
- Run the included authentication helper to generate a refresh token:
GOOGLE_CLIENT_ID=<your_id> GOOGLE_CLIENT_SECRET=<your_secret> python3 -m google_calendar.auth
- Save the tokens securely using the built-in secret management system:
openclaw secret set GOOGLE_CLIENT_ID <value>
openclaw secret set GOOGLE_CLIENT_SECRET <value>
openclaw secret set GOOGLE_REFRESH_TOKEN <value>
openclaw secret set GOOGLE_CALENDAR_ID primary
- Install the required Python dependencies:
pip install --user google-auth google-auth-oauthlib google-api-python-client
Google Calendar Skill Data Schema & Taxonomy
The skill interacts with the Google Calendar API using the following data structure for event management:
| Parameter | Description | Data Type |
|---|---|---|
| title | The summary or name of the calendar event | String |
| start/end | The start and end times for the event | ISO 8601 Timestamp |
| attendees | A list of invitee email addresses | Comma-separated String |
| event-id | The unique identifier used for updating or deleting events | String |
| location | The physical address or meeting link for the event | String |
| desc | A detailed description or notes for the event | String |
Google Calendar Skill Advanced Features
- Full headless server support, enabling Openclaw Skills to run on remote environments without a GUI.
- Support for secondary calendars by specifying a unique GOOGLE_CALENDAR_ID.
- Granular event filtering utilizing time ranges and maximum result limits.
- Secure integration with secret management tools to prevent credential exposure in scripts.
SKILL.md
Loading
Related Openclaw Skills
Raindrop CLI
A powerful command-line interface to manage Raindrop.io bookmarks using the REST API.
Calendar Reminders Skill
A configuration-driven calendar integration that generates structured JSON reminder plans from Google Calendar and CalDAV sources.
Meta Business CLI
A comprehensive CLI tool for automating Meta Business platforms including WhatsApp, Instagram, Facebook Pages, and Messenger via the Graph API.
OpenClaw Gateway Watchdog
A resilient external monitoring service designed to ensure your OpenClaw Gateway maintains 24/7 uptime through automated health checks and restarts.
Ressemble AI Voice Integration
A powerful integration for Openclaw Skills that provides professional-grade text-to-speech synthesis and speech-to-text transcription via Resemble AI.
Cavos CLI Starknet Wallet Manager
A command-line interface skill for managing Starknet assets and smart contract interactions with session-based security.
Featured*
