Calendar Reminders

What This Skill Does

The Calendar Reminders skill is a sophisticated, configuration-driven bridge between local calendar services and the OpenClaw AI ecosystem. At its core, it acts as a wrapper for gcalcli, enabling seamless interaction with Google Calendar from the command line. Additionally, it supports CalDAV integration through vdirsyncer and khal, allowing users to sync events from diverse providers like iCloud. The standout feature is its built-in reminder planner, which processes your calendar events and outputs a structured JSON plan. This plan identifies critical appointments and helps the OpenClaw agent translate them into actionable, one-shot system reminders, ensuring you never miss a deadline.

Installation

To integrate this into your environment, first ensure you have python3 and gcalcli installed. For advanced users requiring CalDAV support, install vdirsyncer and khal via your system package manager. Once dependencies are met, run: clawhub install openclaw/skills/skills/adorostkar/calendar-reminders. After installation, navigate to the references/ directory to copy the example configuration file to ~/.config/openclaw/calendar.json. Be sure to update the file paths and OAuth credentials within the configuration to reflect your specific environment.

Use Cases

This skill is perfect for power users who rely on local terminal workflows to manage their lives. You can use it to synchronize professional Google Calendar appointments with a secondary CalDAV work calendar, unify them into a single list of reminders, and have your AI agent automatically alert you based on the generated JSON plan. It is particularly effective for headless server environments where you need to manage time-sensitive tasks without a GUI.

Example Prompts

1. "OpenClaw, run the calendar reminder planner and update my schedule for today."
2. "Check my Google Calendar via the wrapper and tell me if I have any urgent meetings this afternoon."
3. "Sync my CalDAV calendars and import any new event reminders into my system tasks."

Tips & Limitations

Because this skill invokes external binaries, always use absolute paths in your configuration for security. If running on a headless machine, use SSH port-forwarding to complete the initial Google OAuth handshake. Remember that the planner defaults to ignoring birthdays and only processes all-day events if they contain specific, user-defined keywords. We recommend running the reminder planner as a cron job to maintain a fresh state, but always ensure your cron scripts utilize proper argument lists rather than raw shell strings to prevent injection vulnerabilities.