Procedures

Automation procedures in the Google Calendar book.

The following documentation is for Google Calendar v1.6.3 (BDK).

Make sure to add the Google Calendar book to your agent before using these automation procedures.

to create an (event)

Create a new Google Calendar event.

Input Concepts

Concept	Description	Type	Required	Default Value
event	The event details to create	google calendar event	Yes	(no default)
calendar id	The calendar ID to create the event in (default: "primary")	text	No	primary

Output Concepts

Concept	Description	Type
event	The created event with its ID and other fields set by Google Calendar	google calendar event

Examples

the string is '{"summary": "New event", "start": "07/23/2025T08:00", "end": "07/23/2025T09:00", "attendees": ["[email protected]"], "confirmed_attendees": [], "potential_attendees": []}'
get the string as json
use the above as the new event
create the new event where
  the calendar id is "primary"

to get some (events)

Get events from Google Calendar, optionally filtered by time range.

Input Concepts

Concept	Description	Type	Required	Default Value
start time	Optional start time to filter events	datetime	No	(no default)
end time	Optional end time to filter events	datetime	No	(no default)
calendar id	The calendar ID to get events from (default: "primary")	text	No	primary
max results	Maximum number of events to retrieve (default: 100)	number	No	100

Output Concepts

Concept	Description	Type
events	A list of calendar events	google calendar event

Examples

Get calendar events

get some events with
... the start time is "2023-06-01T00:00:00"
... the end time is "2023-06-30T23:59:59"