google-calendar

name	google-calendar
description	Create, list, and manage Google Calendar events. Use when asked to schedule meetings, check calendar, create events, or manage appointments.

Google Calendar

Create, list, find, and manage events in Google Calendar. Connect your Google account to schedule meetings, check availability, and manage your calendar programmatically.

Requirements

• Install the orth CLI
• Connect your Google Calendar at https://orthogonal.com/dashboard/integrations
• OAuth connection must be active (HTTP 428 response means not connected)

Actions

Create Event

Schedule a new calendar event with attendees and settings.

orth run google-calendar /create-event --body '{
  "start_datetime": "2024-03-15T14:00:00",
  "summary": "Team Meeting",
  "description": "Weekly team sync",
  "event_duration_hour": 1
}'

Parameters:

• start_datetime (required) - Event start time in "YYYY-MM-DDTHH:MM:SS" format (NO timezone)
• summary - Event title/summary
• description - Event description/details
• location - Event location or meeting room
• timezone - IANA timezone (e.g., "America/New_York")
• attendees - Array of attendee email addresses
• event_duration_hour - Duration in hours
• event_duration_minutes - Duration in minutes (0-59 only)
• recurrence - Recurrence rule (RRULE format)
• visibility - Event visibility (default, public, private)
• calendar_id - Specific calendar to create event in
• send_updates - Send email invitations (true/false)
• transparency - Show as busy/free (opaque/transparent)
• exclude_organizer - Exclude organizer from attendee list (true/false)
• guests_can_modify - Allow guests to modify event (true/false)
• create_meeting_room - Create Google Meet room (requires paid Workspace)
• eventType - Event type classification
• guestsCanInviteOthers - Allow guests to invite others (true/false)
• guestsCanSeeOtherGuests - Allow guests to see other attendees (true/false)

List Events

Retrieve events from your calendar within a time range.

orth run google-calendar /list-events --body '{
  "calendarId": "primary",
  "timeMin": "2024-03-01T00:00:00Z",
  "maxResults": 10
}'

Parameters:

• calendarId (required) - Calendar ID to query ("primary" for main calendar)
• timeMin - Start time filter (RFC3339 format)
• timeMax - End time filter (RFC3339 format)
• q - Text search query
• orderBy - Sort order (startTime, updated)
• maxResults - Maximum events to return
• pageToken - Token for pagination
• singleEvents - Expand recurring events (true/false)
• showDeleted - Include deleted events (true/false)
• timeZone - Timezone for results
• eventTypes - Filter by event types
• updatedMin - Only events updated after this time
• maxAttendees - Maximum attendees to return per event
• syncToken - Sync token for incremental sync
• showHiddenInvitations - Include hidden invitations (true/false)

Find Event

Search for specific events by query and filters.

orth run google-calendar /find-event --body '{
  "query": "team meeting",
  "timeMin": "2024-03-01T00:00:00Z"
}'

Parameters:

• query - Search query text
• timeMin - Search start time (RFC3339 format)
• timeMax - Search end time (RFC3339 format)
• calendar_id - Specific calendar to search
• order_by - Sort results (startTime, updated)
• max_results - Maximum results to return
• single_events - Expand recurring events (true/false)
• show_deleted - Include deleted events (true/false)
• event_types - Filter by event types
• page_token - Token for pagination
• updated_min - Only events updated after this time

Delete Event

Remove an event from your calendar.

orth run google-calendar /delete-event --body '{
  "event_id": "EVENT_ID_HERE"
}'

Parameters:

• event_id (required) - Google Calendar event ID to delete
• calendar_id - Calendar containing the event (defaults to primary)

Usage Examples

Schedule a 1-hour meeting:

orth run google-calendar /create-event -b '{"start_datetime":"2024-03-15T14:00:00","summary":"Client Call","event_duration_hour":1,"attendees":["[e-mail]"]}'

Create recurring weekly meeting:

orth run google-calendar /create-event -b '{"start_datetime":"2024-03-15T10:00:00","summary":"Weekly Standup","event_duration_minutes":30,"recurrence":"RRULE:FREQ=WEEKLY;BYDAY=FR"}'

Check today's events:

orth run google-calendar /list-events -b '{"calendarId":"primary","timeMin":"2024-03-15T00:00:00Z","timeMax":"2024-03-15T23:59:59Z"}'

Search for meetings:

orth run google-calendar /find-event -b '{"query":"team meeting","timeMin":"2024-03-01T00:00:00Z"}'

Cancel an event:

orth run google-calendar /delete-event -b '{"event_id":"abc123def456ghi789"}'

Error Handling

• HTTP 428 - Google Calendar integration not connected. Visit https://orthogonal.com/dashboard/integrations to connect your account
• 400 Bad Request - Invalid datetime format or missing required parameters
• 403 Forbidden - Insufficient calendar permissions
• 404 Not Found - Event or calendar does not exist
• 409 Conflict - Event conflicts with existing event
• 429 Rate Limited - Too many requests, wait before retrying

Tips

• Use "primary" as calendarId for your main calendar
• DateTime format must be "YYYY-MM-DDTHH:MM:SS" without timezone
• Set timezone separately using the timezone parameter
• Duration can be specified in hours and/or minutes
• Recurring events use RRULE syntax (e.g., "RRULE:FREQ=WEEKLY")
• Use timeMin/timeMax in RFC3339 format for filtering
• Google Meet rooms require paid Google Workspace
• Event IDs are returned from create/list operations