calendar

calendar.check_availability

Check Calendar Availability

Effects: read, requires channel google_calendar

Check when you have free time in Google Calendar. Shows busy periods and free slots in a given time range. Useful for finding meeting times or checking schedule conflicts.

Arguments

Argument	Type	Required	Description
calendar_id	string	no	Calendar ID to check. OMIT to use the agent's configured default calendar (or primary).
end_time	string	no	End date/time to check availability (YYYY-MM-DD or ISO 8601). Defaults to end of start_time day, or 7 days from now.
min_duration_minutes	integer	no	Minimum duration in minutes for free slots. Filters out short gaps. Default: 30 minutes. (default 30)
start_time	string	no	Start date/time to check availability (YYYY-MM-DD or ISO 8601). Defaults to start of today.
working_hours_only	boolean	no	If true, only show free slots during working hours (9 AM - 6 PM). OMIT to show all free time (the default).

calendar.create_event

Create Calendar Event

Effects: schedule, external_api, requires channel google_calendar

Create a new event in Google Calendar. Specify the title, start time, end time, and optionally invite attendees. Use ISO 8601 format for dates (e.g., 2024-12-15T14:00:00).

Arguments

Argument	Type	Required	Description
add_google_meet	boolean	no	If true, automatically creates a Google Meet link for the event. OMIT to skip Meet link.
attendees	array	no	List of attendee email addresses to invite.
calendar_id	string	no	Calendar ID to create the event in. OMIT to use the agent's configured default calendar (or primary).
conference_data	object	no	Conference data for Google Meet. Alternative to add_google_meet flag.
description	string	no	Event description/notes.
end	string	no	Event end time in ISO 8601 format. If not provided, defaults to 1 hour after start. Also accepts 'end_time' as alias.
end_time	string	no	Alias for end - event end time.
location	string	no	Event location (physical address or virtual meeting link).
start	string	no	Event start time in ISO 8601 format (e.g., 2024-12-15T14:00:00). Also accepts 'start_time' as alias.
start_time	string	no	Alias for start - event start time in ISO 8601 format.
summary	string	no	Event title/summary. Required. Also accepts 'title' as alias.
timezone	string	no	Timezone for the event (e.g., 'America/New_York', 'UTC').
title	string	no	Alias for summary - event title.

calendar.delete_event

Delete Calendar Event

Effects: delete, external_api, requires channel google_calendar

Delete an event from Google Calendar. This action cannot be undone. Use with caution.

Arguments

Argument	Type	Required	Description
calendar_id	string	no	Calendar ID containing the event. OMIT to use the agent's configured default calendar (or primary).
event_id	string	yes	ID of the event to delete. Required.
send_notifications	boolean	no	Whether to send cancellation notifications to attendees. (default True)

calendar.list_events

List Calendar Events

Effects: read, requires channel google_calendar

List events from Google Calendar. Shows upcoming events by default. Can filter by date range and search query.

Arguments

Argument	Type	Required	Description
calendar_id	string	no	Calendar ID to list events from. OMIT to use the agent's configured default calendar (or primary).
date_from	string	no	Start date/time to query (YYYY-MM-DD or ISO 8601 format). Defaults to now. Alias: time_min.
date_to	string	no	End date/time to query (YYYY-MM-DD or ISO 8601 format). Defaults to 7 days from now. Alias: time_max.
max_results	integer	no	Maximum number of events to return. (default 25)
query	string	no	Free text search query to filter events.

calendar.update_event

Update Calendar Event

Effects: schedule, external_api, requires channel google_calendar

Update an existing event in Google Calendar. Can modify title, time, location, description, and attendees. Only specified fields will be updated.

Arguments

Argument	Type	Required	Description
attendees	array	no	New list of attendee emails. Replaces existing attendees.
calendar_id	string	no	Calendar ID containing the event. OMIT to use the agent's configured default calendar (or primary).
description	string	no	New event description. Optional.
end	string	no	New end time in ISO 8601 format. Optional.
event_id	string	yes	ID of the event to update. Required.
location	string	no	New event location. Optional.
start	string	no	New start time in ISO 8601 format. Optional.
summary	string	no	New event title/summary. Optional.