calendar

What This Skill Does

The Calendar Skill allows the OpenClaw AI agent to manage your Google Calendar directly from the command line interface using the gcalcli utility. It acts as an bridge between your natural language requests and the robust gcalcli tool, enabling you to list upcoming appointments, schedule new meetings, and remove outdated events without needing to open a browser. This integration is designed for users who live in the terminal and want to maintain their schedule without breaking their workflow context. By leveraging the power of Google Calendar APIs, it ensures your agenda is always synchronized.

Installation

To integrate this functionality into your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/xejrax/brainz-calendar

Ensure that you have gcalcli installed on your system via pip install gcalcli. You must also configure your Google Calendar API credentials or CalDAV settings as documented in the gcalcli manual. Once the skill is installed and authenticated, the OpenClaw agent will be able to interpret your requests regarding your time management and execute the appropriate shell commands to update your calendar state.

Use Cases

This skill is perfect for developers and power users who prefer keyboard-centric workflows. Use it to quickly check your availability for the day without context-switching, or to add a meeting reminder immediately after a slack message or email discussion. It is particularly useful for setting up recurring reminders or blocking out deep work time in your calendar based on your terminal-based project management logs. It is also excellent for quick cleanup tasks, such as removing cancelled meetings to keep your schedule clean.

Example Prompts

1. "What does my schedule look like between February 3rd and February 10th?"
2. "Add a 30-minute team sync meeting titled 'Project Sync' for tomorrow at 10:00 AM."
3. "Please delete the 'Marketing Sync' meeting from my calendar today."

Tips & Limitations

• Authentication: Ensure your GOOGLE_CALENDAR_API_KEY is properly exported in your environment variables, otherwise the skill will fail to authenticate.
• Precision: When adding events, be as specific as possible with date and time formats to avoid parsing errors.
• Search Terms: The deletion command relies on string matching. Use unique names for events to prevent accidental deletion of multiple similar meetings.
• Limitations: This skill does not support advanced Google Calendar features like inviting guests or managing shared calendars directly via the command interface. It is best suited for personal schedule management.