google-calendar

What This Skill Does

The google-calendar skill for OpenClaw is a powerful automation tool designed to bridge the gap between your natural language requests and your Google Calendar ecosystem. It allows you to create, update, and query calendar events directly through the OpenClaw agent. By managing your scheduling, availability, and agenda, this skill acts as a personal administrative assistant, reducing context switching and manual browser interaction. It supports multiple account management, enabling you to keep work and personal schedules distinct while maintaining a unified interface for interaction.

Installation

To install this skill, run clawhub install openclaw/skills/skills/sheldenshi/google-calendar-master in your terminal. After installation, navigate to the scripts directory by running cd ~/.openclaw/skills/google-calendar/scripts. Ensure you complete the first-time setup: check for ~/.config/google-calendar-skill/client.json, run bun run auth.ts login to authorize your account, and use the label command to organize your accounts by purpose (e.g., 'work' or 'personal'). Once labeled, verify your setup by running bun run calendar.ts calendars to list your active calendars.

Use Cases

• Schedule Management: Quickly add meetings or appointments while you are in the middle of a coding session or documentation task.
• Agenda Review: Ask the agent for an overview of your day or week to identify upcoming conflicts.
• Account Switching: Maintain a professional boundary by easily querying specific calendars associated with distinct accounts (e.g., checking if you are free on your 'work' calendar while discussing a 'personal' project).
• Availability Checks: Let the agent determine if you have overlapping commitments without opening the Google Calendar web interface.

Example Prompts

1. "Check my Google Calendar for any meetings scheduled for tomorrow morning between 9 AM and 12 PM."
2. "Add a lunch meeting with Sarah this Friday at 1 PM to my work calendar."
3. "Do I have any conflicts for the project sync scheduled on my personal calendar next Tuesday?"

Tips & Limitations

• Pro-tip: Always use the label command during setup to give your accounts descriptive names; this makes interacting with multiple calendars significantly easier when sending prompts to the agent.
• Maintenance: Tokens will auto-refresh, but if you encounter authentication errors, you can use bun run auth.ts refresh to manually trigger an update.
• Constraints: All commands must be executed within the scripts/ directory of the skill installation. The skill relies on local configuration files; ensure your permissions allow the agent to read and write to ~/.config/google-calendar-skill/.