Skills Reference
Google Calendar
What it does
Connects to your Google Calendar so your assistant can view your schedule, create events, check availability, and help manage your time.
Setup required
OAuth2 connection to your Google account. Say:
“Connect my Google Calendar.”
Your assistant opens a Google authorization page. Log in, grant access, done. One-time setup.
Permissions
- Requires OAuth2 authorization with Google
- Calendar read/write access (scoped to calendar only, not your entire Google account)
- No macOS permissions needed
Common prompts
| You say... | What happens |
|---|---|
| “What's on my calendar today?” | Shows today's events in a clean summary |
| “Am I free Thursday afternoon?” | Checks your availability for the time range |
| “Schedule a meeting with the design team Tuesday at 2pm” | Creates a new calendar event |
| “Move my 3pm to 4pm” | Reschedules an existing event |
| “What does my week look like?” | Overview of the entire week's events |
| “Find a 30-minute slot for a call this week” | Searches for open windows in your schedule |
| “Cancel my Friday standup” | Removes an event |
Configuration
- Connected to your default Google Calendar
- Supports multiple calendars — your assistant can view events from any calendar on your account and check availability across all of them
Tips & gotchas
- Time zones:Your assistant uses your local timezone (set in USER.md or inferred from your location). If you're scheduling across timezones, be explicit: “Schedule at 2pm EST.”
- Recurring events:Creating and modifying recurring events works, but be specific about what you want changed (“just this one” vs. “all future events”).
- Multiple calendars:Your assistant can view events from any calendar on your Google account. Just mention the calendar by name: “What's on my work calendar tomorrow?”
- Other calendar providers: Only Google Calendar is supported right now. Outlook, Apple Calendar, and others are on the roadmap.
The Personal AI you were promised
