A configuration-driven calendar integration that generates structured JSON reminder plans from Google Calendar and CalDAV sources.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install calendar-reminders
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 calendar-reminders 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 Calendar Reminders Skill?
The Calendar Reminders skill is a sophisticated wrapper designed to bridge the gap between traditional calendar services and autonomous agents. By utilizing gcalcli for Google Calendar and vdirsyncer/khal for CalDAV or iCloud integrations, this tool centralizes your scheduling data. Its primary purpose is to transform disparate calendar events into a cohesive, machine-readable JSON plan that can be consumed by Openclaw Skills for automated notifications and event-driven task execution.
This skill is built with security and flexibility in mind, allowing developers to manage multiple calendar sources through a unified configuration. It simplifies the process of fetching event data on headless servers and provides a robust foundation for building advanced scheduling workflows within the Openclaw Skills ecosystem.
Calendar Reminders Skill Use Cases
- Creating automated meeting alerts for headless AI agent environments.
- Synchronizing personal iCloud or work CalDAV schedules with Openclaw Skills workflows.
- Generating daily JSON-based schedules to trigger custom system events.
- Filtering noisy calendars to only provide reminders for specific keyword-matched events.
How Calendar Reminders Skill Works
- The skill executes gcalcli or khal to fetch event data from your configured calendar providers.
- The calendar_reminder_plan.py script processes the raw data, filtering out birthdays and irrelevant all-day events.
- A structured JSON blob is generated, calculating the exact UTC timestamps for upcoming reminders based on event start times.
- An external cron job or an agent turn consumes this JSON to schedule one-shot system events within Openclaw Skills.
Calendar Reminders Skill Setup
Ensure python3 and gcalcli are installed on your system. For CalDAV support, install vdirsyncer and khal.
mkdir -p ~/.config/openclaw
cp references/openclaw-calendar.example.json ~/.config/openclaw/calendar.json
Edit the configuration file with your preferred settings and binary paths. To authenticate with Google, run the calendar script and follow the OAuth instructions provided in the terminal output. If you are on a headless server, use SSH port-forwarding for the authentication flow.
Calendar Reminders Skill Data Schema & Taxonomy
The skill relies on a central JSON configuration and produces a JSON output plan.
| File/Object | Description |
|---|---|
| calendar.json | Main configuration file for API paths, calendar IDs, and keywords. |
| reminder_plan.json | Output plan containing eventTitle, reminderAtUtc, and metadata. |
| systemEvent | The final Openclaw Skills reminder object triggered at the scheduled time. |
Calendar Reminders Skill Advanced Features
- Keyword-based event filtering to ensure only high-priority all-day events trigger reminders.
- Support for multi-source calendar syncing via vdirsyncer for complex scheduling environments.
- Argument-list based subprocess execution to prevent shell injection and ensure secure binary interaction.
- Flexible environment variable overrides for dynamic configuration path management within Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
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.
News Aggregator Skill
A comprehensive news aggregator that fetches and analyzes real-time content from 8 major global sources using AI-driven semantic filtering.
Tor Browser Automation
Anonymously automate headless browser interactions and scrape .onion sites via the Tor network.
Raindrop CLI
A powerful command-line interface to manage Raindrop.io bookmarks using the REST API.
Google Calendar Skill
A programmatic wrapper for the Google Calendar API allowing agents to manage schedules, events, and appointments via command-line interface.
METADATA
Featured*
