Google Calendar

Create and manage events on Google Calendar.

Create a new event on a Google Calendar.

Parameters

Parameter	Type	Required	Description
`title`	string	Yes	Title of the event
`start_date_time`	string	Yes	When the event starts (for example, 2024-01-15T10:00:00-05:00)
`end_date_time`	string	Yes	When the event ends (for example, 2024-01-15T11:00:00-05:00)
`calendar_id`	string	No	The calendar to add the event to. Leave blank to use your main calendar ('primary')
`description`	string	No	Description or notes for the event
`location`	string	No	Location of the event
`time_zone`	string	No	Time zone for the event (e.g., America/New_York)
`attendees`	array	No	List of attendee email addresses

Response

{
  "event_id": "abc123xyz",
  "html_link": "https://calendar.google.com/calendar/event?eid=abc123xyz"
}

Check if a time slot is available on a Google Calendar.

Parameters

Parameter	Type	Required	Description
`calendar_id`	string	Yes	The calendar to check (use 'primary' for your main calendar)
`start_date_time`	string	Yes	When the time slot starts (for example, 2024-01-15T10:00:00-05:00)
`end_date_time`	string	Yes	When the time slot ends (for example, 2024-01-15T11:00:00-05:00)
`time_zone`	string	No	Time zone for the check (e.g., America/New_York)

Response

{
  "busy": [],
  "busy_summary": "None",
  "is_available": true
}

Delete a calendar event by its title.

Parameters

Parameter	Type	Required	Description
`calendar_id`	string	No	The calendar to remove the event from. Leave blank to use your main calendar ('primary')
`title`	string	Yes	Title of the event to delete
`multiple_mode`	string	No	How to handle multiple matching events: 'first' (delete only the first match) or 'all' (delete all matches)
`send_updates`	string	No	Whether to notify guests about the change: 'all', 'externalOnly', or 'none'

Response

{
  "deleted_event_ids": [
    "event123"
  ]
}