Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
What This Skill Does
Wraps the Google Calendar REST API to list, create, update, and delete calendar events from the command line or automated scripts. Credentials are stored as environment variables and authentication uses OAuth 2.0 refresh tokens. Works headless, no browser or GUI required at runtime.
Runs headless on servers and in CI pipelines where a browser-based calendar UI is not available.
When to use it
- Listing today's meetings before a standup call
- Creating a calendar event from a task automation script
- Bulk-deleting cancelled appointments by event ID
- Checking what's scheduled across a specific date range
- Adding attendees and a location to a new event programmatically
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: Schedule a team sync tomorrow at 2pm with alice@example.com and bob@example.com
- 1Reads GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, and GOOGLE_REFRESH_TOKEN from environment
- 2Refreshes the OAuth access token using the stored refresh token
- 3Calls `google-calendar add --title "Team sync" --start <ISO> --end <ISO> --attendees alice@example.com,bob@example.com`
- 4Google Calendar API creates the event and returns event metadata as JSON
- 5Prints the JSON payload including the new event ID to stdout
JSON object with event ID, title, start/end times, and attendee list
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.