google-calendar

What This Skill Does

The google-calendar skill empowers your OpenClaw agent to manage your Google Calendar ecosystem directly from your terminal. It provides a robust interface for authenticating multiple Google accounts, querying your schedules, and performing calendar operations. By handling the complexities of OAuth authentication and API interaction, it allows you to maintain control over your time, meetings, and availability across professional and personal domains.

Installation

To integrate this skill, navigate to your OpenClaw environment and execute the following command: clawhub install openclaw/skills/skills/sheldenshi/google-calendar-2. Once installed, you must perform the first-time setup: navigate to the skill directory via cd ~/.openclaw/skills/google-calendar/scripts. Check for the existance of client.json as per the documentation, then execute bun run auth.ts login to initiate the browser-based OAuth flow. After authentication, use bun run auth.ts label <name> [purpose] to organize your accounts effectively, and verify your configuration by running bun run calendar.ts calendars to list your active calendars.

Use Cases

This skill is ideal for professionals and power users who spend their time in the command line but need to stay synchronized with their meetings. It is perfect for checking daily agendas without switching contexts to a browser, blocking out deep-work time based on upcoming availability, or managing multiple calendars (e.g., separating 'work' and 'personal' events) through a unified AI interface.

Example Prompts

1. "What does my agenda look like for today?"
2. "Check my work calendar and tell me if I have any meetings between 2 PM and 4 PM."
3. "Add a meeting titled 'Project Sync' to my personal calendar for tomorrow at 10 AM."

Tips & Limitations

Always ensure you are operating from the scripts/ directory to avoid pathing errors. If you ever encounter authentication issues, the bun run auth.ts status and bun run auth.ts refresh commands are your first line of defense. Remember that the skill relies on your local config.json file for account purposes; keeping this file updated ensures the agent makes intelligent decisions about which calendar to use for specific requests. Note that this skill requires active internet connectivity to communicate with Google's APIs and will perform token refreshes automatically to maintain seamless access.