Google Calendar

The Google Calendar integration enables agents to create events, check availability, and manage calendars.

Setup

skillett connect google-calendar

Skillett handles all authentication automatically when you connect.

Endpoints

Endpoint	Method	Description
list_events	GET	List events on a calendar
get_event	GET	Get a specific event
create_event	POST	Create a new event
update_event	PATCH	Update an existing event
delete_event	DELETE	Delete an event
list_calendars	GET	List available calendars
get_calendar	GET	Get calendar details
create_calendar	POST	Create a new calendar
freebusy_query	POST	Check availability
quick_add	POST	Create event from text (natural language)

Example usage

# List today's events
skillett run google-calendar list_events --calendarId primary --timeMin "2026-04-08T00:00:00Z" --timeMax "2026-04-08T23:59:59Z"

# Create a meeting
skillett run google-calendar create_event --calendarId primary --summary "Team standup" --start '{"dateTime":"2026-04-09T09:00:00Z"}' --end '{"dateTime":"2026-04-09T09:30:00Z"}'

# Quick add from text
skillett run google-calendar quick_add --calendarId primary --text "Lunch with Sarah tomorrow at noon"

Common patterns

• Calendar ID: Use primary for the user’s main calendar
• Timestamps: ISO 8601 format with timezone (e.g., 2026-04-08T10:00:00-05:00)
• Recurring events: Supports RRULE format for recurrence