Calendar

REST Provider
scheduling
4 methods

List calendars and events, create events, and retrieve event details from Google Calendar.

See SDK Overview for installation and initialization.

listCalendars

Returns all calendars the user has access to.

TypeScript
const calendar = integrations.calendar
const calendars = await calendar.listCalendars()
// => [{ id: 'primary', summary: 'My Calendar', ... }, ...]

listEvents

List events from a calendar. Supports time range filtering, search queries, and pagination.

TypeScript
// Upcoming events from primary calendar
const events = await calendar.listEvents({
calendarId: 'primary',
timeMin: new Date().toISOString(),
maxResults: 20,
singleEvents: true,
orderBy: 'startTime',
})
// Search events by keyword
const meetings = await calendar.listEvents({
query: 'standup',
timeMin: '2026-04-10T00:00:00Z',
timeMax: '2026-04-17T00:00:00Z',
})

createEvent

Create a new event on the user's calendar. Supports attendees, location, and description.

TypeScript
const event = await calendar.createEvent({
calendarId: 'primary',
summary: 'Team standup',
description: 'Daily sync meeting',
location: 'Zoom',
start: { dateTime: '2026-04-11T09:00:00-04:00' },
end: { dateTime: '2026-04-11T09:30:00-04:00' },
attendees: [
{ email: 'alice@company.com' },
{ email: 'bob@company.com' },
],
})

getEvent

Retrieve a single event by its ID.

TypeScript
const event = await calendar.getEvent(eventId)
// From a specific calendar
const event = await calendar.getEvent(eventId, 'work-calendar-id')