Google Calendar

Google Calendar MCP Server for Cloudflare Workers

Available Tools

33 tools available in the Google Calendar MCP server. Each tool can be called by AI assistants to perform specific actions.

googlecalendar_get_calendar

Get metadata for a calendar.

Args:

calendarId: Calendar identifier (use 'primary' for the primary calendar)
format: Response format

{
  "type": "object",
  "required": [
    "calendarId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "calendarId": {
      "type": "string",
      "description": "Calendar ID"
    }
  }
}

googlecalendar_list_acl

List access control rules for a calendar.

Returns all sharing rules and permissions for the specified calendar.

Args:

calendarId: Calendar identifier
maxResults: Maximum rules to return
pageToken: Token for pagination
showDeleted: Include deleted rules
format: Response format

{
  "type": "object",
  "required": [
    "calendarId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pageToken": {
      "type": "string",
      "description": "Page token"
    },
    "calendarId": {
      "type": "string",
      "description": "Calendar ID"
    },
    "maxResults": {
      "type": "integer",
      "minimum": 1,
      "description": "Max results"
    },
    "showDeleted": {
      "type": "boolean",
      "description": "Show deleted rules"
    }
  }
}

googlecalendar_get_acl_rule

Get a specific access control rule.

Args:

calendarId: Calendar identifier
ruleId: ACL rule identifier (e.g., 'user:email@example.com')
format: Response format

{
  "type": "object",
  "required": [
    "calendarId",
    "ruleId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "ruleId": {
      "type": "string",
      "description": "ACL rule ID"
    },
    "calendarId": {
      "type": "string",
      "description": "Calendar ID"
    }
  }
}

googlecalendar_share_calendar

Share a calendar by creating an access control rule.

Role descriptions:

none: Remove access
freeBusyReader: Can see free/busy only
reader: Can see all event details
writer: Can edit events
owner: Full control (can share and delete the calendar)

Scope types:

default: Public access (no value needed)
user: Share with a specific user (value = email)
group: Share with a Google group (value = group email)
domain: Share with everyone in a domain (value = domain name)

Args:

calendarId: Calendar identifier
role: Access level to grant
scope: Who to share with
sendNotifications: Whether to send sharing notification

{
  "type": "object",
  "required": [
    "calendarId"
  ],
  "properties": {
    "calendarId": {
      "type": "string",
      "description": "Calendar ID"
    },
    "sendNotifications": {
      "type": "boolean",
      "description": "Send notification email"
    }
  }
}

googlecalendar_update_acl_rule

Update an access control rule (full update).

Args:

calendarId: Calendar identifier
ruleId: ACL rule identifier
role: New access level
scope: Scope of the rule
sendNotifications: Whether to send notification

{
  "type": "object",
  "required": [
    "calendarId",
    "ruleId"
  ],
  "properties": {
    "ruleId": {
      "type": "string",
      "description": "ACL rule ID"
    },
    "calendarId": {
      "type": "string",
      "description": "Calendar ID"
    },
    "sendNotifications": {
      "type": "boolean",
      "description": "Send notification email"
    }
  }
}

googlecalendar_patch_acl_rule

Partially update an access control rule.

Only updates the specified fields.

Args:

calendarId: Calendar identifier
ruleId: ACL rule identifier
role: New access level
sendNotifications: Whether to send notification

{
  "type": "object",
  "required": [
    "calendarId"
  ],
  "properties": {
    "ruleId": {
      "type": "string",
      "description": "ACL rule ID"
    },
    "calendarId": {
      "type": "string",
      "description": "Calendar ID"
    },
    "sendNotifications": {
      "type": "boolean",
      "description": "Send notification email"
    }
  }
}

googlecalendar_unshare_calendar

Remove calendar sharing by deleting an access control rule.

Args:

calendarId: Calendar identifier
ruleId: ACL rule identifier to delete

{
  "type": "object",
  "required": [
    "calendarId",
    "ruleId"
  ],
  "properties": {
    "ruleId": {
      "type": "string",
      "description": "ACL rule ID"
    },
    "calendarId": {
      "type": "string",
      "description": "Calendar ID"
    }
  }
}

googlecalendar_list_calendar_list

List all calendars on the user's calendar list.

Returns a paginated list of the user's calendar entries. Use pageToken to fetch subsequent pages.

Args:

maxResults: Maximum number of entries to return (1-250)
pageToken: Token from previous response for pagination
minAccessRole: Filter by minimum access role
showDeleted: Whether to include deleted calendar list entries
showHidden: Whether to show hidden entries
format: Response format ('json' or 'markdown')

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "pageToken": {
      "type": "string",
      "description": "Page token for pagination"
    },
    "showHidden": {
      "type": "boolean",
      "description": "Show hidden entries"
    },
    "showDeleted": {
      "type": "boolean",
      "description": "Include deleted entries"
    }
  }
}

googlecalendar_get_calendar_list_entry

Get a specific calendar list entry.

Args:

calendarId: Calendar identifier (use 'primary' for the primary calendar)
format: Response format

{
  "type": "object",
  "required": [
    "calendarId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "calendarId": {
      "type": "string",
      "description": "Calendar ID"
    }
  }
}

googlecalendar_insert_calendar_list_entry

Add an existing calendar to the user's calendar list.

This adds a calendar that already exists (e.g., a shared calendar) to the user's list.

Args:

id: Calendar identifier to add
colorId: Color ID for the calendar
backgroundColor: Custom background color (hex)
foregroundColor: Custom foreground color (hex)
hidden: Whether to hide from the list
selected: Whether to show in calendar UI
summaryOverride: Custom display name
defaultReminders: Default reminders for events

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Calendar ID to add"
    },
    "hidden": {
      "type": "boolean",
      "description": "Hide from list"
    },
    "colorId": {
      "type": "string",
      "description": "Color ID"
    },
    "selected": {
      "type": "boolean",
      "description": "Show in calendar UI"
    },
    "backgroundColor": {
      "type": "string",
      "description": "Background color (hex)"
    },
    "foregroundColor": {
      "type": "string",
      "description": "Foreground color (hex)"
    },
    "summaryOverride": {
      "type": "string",
      "description": "Custom display name"
    },
    "defaultReminders": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Default reminders"
    }
  }
}

googlecalendar_update_calendar_list_entry

Update an entry on the user's calendar list (full update).

Args:

calendarId: Calendar identifier
colorId: Color ID for the calendar
backgroundColor: Custom background color (hex)
foregroundColor: Custom foreground color (hex)
hidden: Whether to hide from the list
selected: Whether to show in calendar UI
summaryOverride: Custom display name
defaultReminders: Default reminders for events

{
  "type": "object",
  "required": [
    "calendarId"
  ],
  "properties": {
    "hidden": {
      "type": "boolean",
      "description": "Hide from list"
    },
    "colorId": {
      "type": "string",
      "description": "Color ID"
    },
    "selected": {
      "type": "boolean",
      "description": "Show in calendar UI"
    },
    "calendarId": {
      "type": "string",
      "description": "Calendar ID"
    },
    "backgroundColor": {
      "type": "string",
      "description": "Background color (hex)"
    },
    "foregroundColor": {
      "type": "string",
      "description": "Foreground color (hex)"
    },
    "summaryOverride": {
      "type": "string",
      "description": "Custom display name"
    },
    "defaultReminders": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Default reminders"
    }
  }
}

googlecalendar_patch_calendar_list_entry

Partially update an entry on the user's calendar list.

Only updates the specified fields, leaving others unchanged.

Args:

calendarId: Calendar identifier
colorId: Color ID for the calendar
backgroundColor: Custom background color (hex)
foregroundColor: Custom foreground color (hex)
hidden: Whether to hide from the list
selected: Whether to show in calendar UI
summaryOverride: Custom display name

{
  "type": "object",
  "required": [
    "calendarId"
  ],
  "properties": {
    "hidden": {
      "type": "boolean",
      "description": "Hide from list"
    },
    "colorId": {
      "type": "string",
      "description": "Color ID"
    },
    "selected": {
      "type": "boolean",
      "description": "Show in calendar UI"
    },
    "calendarId": {
      "type": "string",
      "description": "Calendar ID"
    },
    "backgroundColor": {
      "type": "string",
      "description": "Background color (hex)"
    },
    "foregroundColor": {
      "type": "string",
      "description": "Foreground color (hex)"
    },
    "summaryOverride": {
      "type": "string",
      "description": "Custom display name"
    }
  }
}

googlecalendar_delete_calendar_list_entry

Remove a calendar from the user's calendar list.

This removes the calendar from the user's list but does not delete the calendar itself.

Args:

calendarId: Calendar identifier to remove

{
  "type": "object",
  "required": [
    "calendarId"
  ],
  "properties": {
    "calendarId": {
      "type": "string",
      "description": "Calendar ID to remove"
    }
  }
}

googlecalendar_create_calendar

Create a new secondary calendar.

The calendar is created with the authenticated user as the owner. Note: Primary calendars cannot be created; they are automatically created for users.

Args:

summary: Title of the calendar (required)
description: Description of the calendar
location: Geographic location as free-form text
timeZone: IANA time zone (e.g., 'America/New_York')

{
  "type": "object",
  "required": [
    "summary"
  ],
  "properties": {
    "summary": {
      "type": "string",
      "description": "Calendar title"
    },
    "location": {
      "type": "string",
      "description": "Geographic location"
    },
    "timeZone": {
      "type": "string",
      "description": "Time zone (IANA format)"
    },
    "description": {
      "type": "string",
      "description": "Calendar description"
    }
  }
}

googlecalendar_update_calendar

Update metadata for a calendar (full update).

Args:

calendarId: Calendar identifier
summary: Title of the calendar
description: Description of the calendar
location: Geographic location
timeZone: Time zone (IANA format)

{
  "type": "object",
  "required": [
    "calendarId"
  ],
  "properties": {
    "summary": {
      "type": "string",
      "description": "Calendar title"
    },
    "location": {
      "type": "string",
      "description": "Geographic location"
    },
    "timeZone": {
      "type": "string",
      "description": "Time zone (IANA format)"
    },
    "calendarId": {
      "type": "string",
      "description": "Calendar ID"
    },
    "description": {
      "type": "string",
      "description": "Calendar description"
    }
  }
}

googlecalendar_patch_calendar

Partially update metadata for a calendar.

Only updates the specified fields, leaving others unchanged.

Args:

calendarId: Calendar identifier
summary: Title of the calendar
description: Description of the calendar
location: Geographic location
timeZone: Time zone (IANA format)

{
  "type": "object",
  "required": [
    "calendarId"
  ],
  "properties": {
    "summary": {
      "type": "string",
      "description": "Calendar title"
    },
    "location": {
      "type": "string",
      "description": "Geographic location"
    },
    "timeZone": {
      "type": "string",
      "description": "Time zone (IANA format)"
    },
    "calendarId": {
      "type": "string",
      "description": "Calendar ID"
    },
    "description": {
      "type": "string",
      "description": "Calendar description"
    }
  }
}

googlecalendar_delete_calendar

Delete a secondary calendar.

The primary calendar cannot be deleted; use clear instead to remove all events.

Args:

calendarId: Calendar identifier to delete

{
  "type": "object",
  "required": [
    "calendarId"
  ],
  "properties": {
    "calendarId": {
      "type": "string",
      "description": "Calendar ID to delete"
    }
  }
}

googlecalendar_clear_calendar

Clear a primary calendar.

Deletes all events from the primary calendar of an account. This operation cannot be undone. Note: Only works on the primary calendar.

Args:

calendarId: Calendar identifier (usually 'primary')

{
  "type": "object",
  "required": [
    "calendarId"
  ],
  "properties": {
    "calendarId": {
      "type": "string",
      "description": "Calendar ID (usually \"primary"
    }
  }
}

googlecalendar_stop_channel

Stop receiving push notifications for a channel.

This stops watching for changes that were set up using a watch request. You need the channel ID and resource ID that were returned when the watch was created.

Note: Watch channels for CalendarList, Events, ACL, and Settings must be created through their respective watch endpoints, which are not currently implemented.

Args:

id: The channel ID (UUID) returned from a watch request
resourceId: The resource ID returned from a watch request

{
  "type": "object",
  "required": [
    "id",
    "resourceId"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Channel ID (UUID)"
    },
    "resourceId": {
      "type": "string",
      "description": "Resource ID from watch"
    }
  }
}

googlecalendar_get_colors

Get the color definitions for calendars and events.

Returns two color palettes:

Calendar colors: Used for the colorId field in CalendarListEntry
Event colors: Used for the colorId field in Event

Each color has:

background: Hex color for the background
foreground: Hex color for the text

Use these IDs when setting colors on calendars or events.

Args:

format: Response format ('json' or 'markdown')

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

googlecalendar_list_events

List events on a calendar.

Returns events within the specified time range. Use singleEvents=true to expand recurring events.

Args:

calendarId: Calendar identifier (use 'primary' for primary calendar)
maxResults: Maximum events to return (1-2500)
pageToken: Token for pagination
timeMin: Lower bound (RFC3339, exclusive)
timeMax: Upper bound (RFC3339, exclusive)
q: Search query (searches summary, description, location, attendee names/emails)
singleEvents: Expand recurring events into instances
orderBy: Sort order ('startTime' requires singleEvents=true, or 'updated')
showDeleted: Include deleted events
showHiddenInvitations: Show hidden invitations
timeZone: Time zone for response
updatedMin: Filter by last modification time
iCalUID: Filter by iCalendar UID
format: Response format

{
  "type": "object",
  "required": [
    "calendarId"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "Search query"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "iCalUID": {
      "type": "string",
      "description": "iCalendar UID filter"
    },
    "orderBy": {
      "enum": [
        "startTime",
        "updated"
      ],
      "type": "string",
      "description": "Sort order"
    },
    "timeMax": {
      "type": "string",
      "description": "End time (RFC3339)"
    },
    "timeMin": {
      "type": "string",
      "description": "Start time (RFC3339)"
    },
    "timeZone": {
      "type": "string",
      "description": "Time zone"
    },
    "pageToken": {
      "type": "string",
      "description": "Page token"
    },
    "calendarId": {
      "type": "string",
      "description": "Calendar ID"
    },
    "maxResults": {
      "type": "integer",
      "maximum": 2500,
      "minimum": 1,
      "description": "Max results"
    },
    "updatedMin": {
      "type": "string",
      "description": "Updated after (RFC3339)"
    },
    "showDeleted": {
      "type": "boolean",
      "description": "Show deleted"
    },
    "singleEvents": {
      "type": "boolean",
      "description": "Expand recurring events"
    },
    "showHiddenInvitations": {
      "type": "boolean",
      "description": "Show hidden invitations"
    }
  }
}

googlecalendar_get_event

Get a specific event.

Args:

calendarId: Calendar identifier
eventId: Event identifier
timeZone: Time zone for the response
maxAttendees: Maximum number of attendees to include
format: Response format

{
  "type": "object",
  "required": [
    "calendarId",
    "eventId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "eventId": {
      "type": "string",
      "description": "Event ID"
    },
    "timeZone": {
      "type": "string",
      "description": "Time zone"
    },
    "calendarId": {
      "type": "string",
      "description": "Calendar ID"
    },
    "maxAttendees": {
      "type": "integer",
      "description": "Max attendees"
    }
  }
}

googlecalendar_quick_add_event

Create an event from a text string.

Parses natural language to create an event. Examples:

"Meeting with John tomorrow at 3pm"
"Dinner at 7pm on Friday"
"Team standup every weekday at 9am"

Args:

calendarId: Calendar identifier
text: Natural language event description
sendUpdates: Send notifications

{
  "type": "object",
  "required": [
    "calendarId",
    "text"
  ],
  "properties": {
    "text": {
      "type": "string",
      "description": "Natural language event text"
    },
    "calendarId": {
      "type": "string",
      "description": "Calendar ID"
    },
    "sendUpdates": {
      "enum": [
        "all",
        "externalOnly",
        "none"
      ],
      "type": "string",
      "description": "Send notifications"
    }
  }
}

googlecalendar_create_event

Create a new event.

For all-day events, use 'date' in start/end. For timed events, use 'dateTime'.

Args:

calendarId: Calendar identifier
summary: Event title
description: Event description
location: Geographic location
start: Start time (object with date or dateTime and optional timeZone)
end: End time (object with date or dateTime and optional timeZone)
attendees: List of attendees
recurrence: RRULE strings for recurring events
visibility: Event visibility
colorId: Color ID
reminders: Reminder settings
guestsCanInviteOthers: Allow guests to invite others
guestsCanModify: Allow guests to modify
guestsCanSeeOtherGuests: Allow guests to see other guests
sendUpdates: Send notifications ('all', 'externalOnly', 'none')

{
  "type": "object",
  "required": [
    "calendarId",
    "summary"
  ],
  "properties": {
    "colorId": {
      "type": "string",
      "description": "Color ID"
    },
    "summary": {
      "type": "string",
      "description": "Event title"
    },
    "location": {
      "type": "string",
      "description": "Location"
    },
    "attendees": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Attendees"
    },
    "calendarId": {
      "type": "string",
      "description": "Calendar ID"
    },
    "recurrence": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Recurrence rules"
    },
    "description": {
      "type": "string",
      "description": "Description"
    },
    "sendUpdates": {
      "enum": [
        "all",
        "externalOnly",
        "none"
      ],
      "type": "string",
      "description": "Send notifications"
    },
    "guestsCanModify": {
      "type": "boolean",
      "description": "Guests can modify"
    },
    "guestsCanInviteOthers": {
      "type": "boolean",
      "description": "Guests can invite"
    },
    "guestsCanSeeOtherGuests": {
      "type": "boolean",
      "description": "Guests can see others"
    }
  }
}

googlecalendar_update_event

Update an event (full update).

All writable fields must be provided; unspecified fields will be cleared.

Args:

calendarId: Calendar identifier
eventId: Event identifier
summary: Event title
description: Event description
location: Geographic location
start: Start time
end: End time
attendees: List of attendees
recurrence: Recurrence rules
visibility: Event visibility
colorId: Color ID
status: Event status
reminders: Reminder settings
sendUpdates: Send notifications

{
  "type": "object",
  "required": [
    "calendarId",
    "eventId"
  ],
  "properties": {
    "status": {
      "enum": [
        "confirmed",
        "tentative",
        "cancelled"
      ],
      "type": "string",
      "description": "Status"
    },
    "colorId": {
      "type": "string",
      "description": "Color ID"
    },
    "eventId": {
      "type": "string",
      "description": "Event ID"
    },
    "summary": {
      "type": "string",
      "description": "Event title"
    },
    "location": {
      "type": "string",
      "description": "Location"
    },
    "attendees": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Attendees"
    },
    "calendarId": {
      "type": "string",
      "description": "Calendar ID"
    },
    "recurrence": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Recurrence rules"
    },
    "description": {
      "type": "string",
      "description": "Description"
    },
    "sendUpdates": {
      "enum": [
        "all",
        "externalOnly",
        "none"
      ],
      "type": "string",
      "description": "Send notifications"
    }
  }
}

googlecalendar_patch_event

Partially update an event.

Only updates the specified fields, leaving others unchanged.

Args:

calendarId: Calendar identifier
eventId: Event identifier
summary: Event title
description: Event description
location: Geographic location
start: Start time
end: End time
attendees: List of attendees
visibility: Event visibility
colorId: Color ID
status: Event status
sendUpdates: Send notifications

{
  "type": "object",
  "required": [
    "calendarId",
    "eventId"
  ],
  "properties": {
    "status": {
      "enum": [
        "confirmed",
        "tentative",
        "cancelled"
      ],
      "type": "string",
      "description": "Status"
    },
    "colorId": {
      "type": "string",
      "description": "Color ID"
    },
    "eventId": {
      "type": "string",
      "description": "Event ID"
    },
    "summary": {
      "type": "string",
      "description": "Event title"
    },
    "location": {
      "type": "string",
      "description": "Location"
    },
    "attendees": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Attendees"
    },
    "calendarId": {
      "type": "string",
      "description": "Calendar ID"
    },
    "description": {
      "type": "string",
      "description": "Description"
    },
    "sendUpdates": {
      "enum": [
        "all",
        "externalOnly",
        "none"
      ],
      "type": "string",
      "description": "Send notifications"
    }
  }
}

googlecalendar_delete_event

Delete an event.

For recurring events, this deletes all instances.

Args:

calendarId: Calendar identifier
eventId: Event identifier
sendUpdates: Send cancellation notifications

{
  "type": "object",
  "required": [
    "calendarId",
    "eventId"
  ],
  "properties": {
    "eventId": {
      "type": "string",
      "description": "Event ID"
    },
    "calendarId": {
      "type": "string",
      "description": "Calendar ID"
    },
    "sendUpdates": {
      "enum": [
        "all",
        "externalOnly",
        "none"
      ],
      "type": "string",
      "description": "Send notifications"
    }
  }
}

googlecalendar_import_event

Import an event with a specified iCalendar UID.

This is used for importing events from other calendar systems. The UID must be globally unique.

Args:

calendarId: Calendar identifier
iCalUID: Unique iCalendar identifier
summary: Event title
description: Event description
location: Geographic location
start: Start time
end: End time
attendees: List of attendees
recurrence: Recurrence rules
visibility: Event visibility
colorId: Color ID
status: Event status

{
  "type": "object",
  "required": [
    "calendarId",
    "iCalUID"
  ],
  "properties": {
    "status": {
      "enum": [
        "confirmed",
        "tentative",
        "cancelled"
      ],
      "type": "string",
      "description": "Status"
    },
    "colorId": {
      "type": "string",
      "description": "Color ID"
    },
    "iCalUID": {
      "type": "string",
      "description": "iCalendar UID"
    },
    "summary": {
      "type": "string",
      "description": "Event title"
    },
    "location": {
      "type": "string",
      "description": "Location"
    },
    "attendees": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Attendees"
    },
    "calendarId": {
      "type": "string",
      "description": "Calendar ID"
    },
    "recurrence": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Recurrence rules"
    },
    "description": {
      "type": "string",
      "description": "Description"
    }
  }
}

googlecalendar_move_event

Move an event to another calendar.

The event is moved from the source calendar to the destination calendar.

Args:

calendarId: Source calendar identifier
eventId: Event identifier
destination: Destination calendar identifier
sendUpdates: Send notifications

{
  "type": "object",
  "required": [
    "calendarId",
    "eventId",
    "destination"
  ],
  "properties": {
    "eventId": {
      "type": "string",
      "description": "Event ID"
    },
    "calendarId": {
      "type": "string",
      "description": "Source calendar ID"
    },
    "destination": {
      "type": "string",
      "description": "Destination calendar ID"
    },
    "sendUpdates": {
      "enum": [
        "all",
        "externalOnly",
        "none"
      ],
      "type": "string",
      "description": "Send notifications"
    }
  }
}

googlecalendar_list_event_instances

List instances of a recurring event.

Returns all instances of a recurring event within the specified time range.

Args:

calendarId: Calendar identifier
eventId: Recurring event identifier
maxResults: Maximum instances to return
pageToken: Token for pagination
timeMin: Lower bound (RFC3339)
timeMax: Upper bound (RFC3339)
timeZone: Time zone
showDeleted: Include deleted instances
maxAttendees: Maximum attendees per instance
format: Response format

{
  "type": "object",
  "required": [
    "calendarId",
    "eventId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "eventId": {
      "type": "string",
      "description": "Recurring event ID"
    },
    "timeMax": {
      "type": "string",
      "description": "End time (RFC3339)"
    },
    "timeMin": {
      "type": "string",
      "description": "Start time (RFC3339)"
    },
    "timeZone": {
      "type": "string",
      "description": "Time zone"
    },
    "pageToken": {
      "type": "string",
      "description": "Page token"
    },
    "calendarId": {
      "type": "string",
      "description": "Calendar ID"
    },
    "maxResults": {
      "type": "integer",
      "minimum": 1,
      "description": "Max results"
    },
    "showDeleted": {
      "type": "boolean",
      "description": "Show deleted"
    },
    "maxAttendees": {
      "type": "integer",
      "description": "Max attendees"
    }
  }
}

googlecalendar_query_freebusy

Query free/busy information for a set of calendars.

Returns busy times for the specified calendars within the given time range. Useful for finding available meeting times.

Args:

timeMin: Start of the interval (RFC3339 format, e.g., '2024-01-15T09:00:00Z')
timeMax: End of the interval (RFC3339 format)
items: List of calendar IDs to query (use 'primary' for primary calendar)
timeZone: Time zone for the response (IANA format, e.g., 'America/New_York')
groupExpansionMax: Maximum number of calendars for a single group (default 50)
calendarExpansionMax: Maximum calendar identifiers per group (default 50)
format: Response format

{
  "type": "object",
  "required": [
    "timeMin",
    "timeMax"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "timeMax": {
      "type": "string",
      "description": "End time (RFC3339)"
    },
    "timeMin": {
      "type": "string",
      "description": "Start time (RFC3339)"
    },
    "timeZone": {
      "type": "string",
      "description": "Time zone"
    },
    "groupExpansionMax": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Max calendars per group"
    },
    "calendarExpansionMax": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Max identifiers per group"
    }
  }
}

googlecalendar_list_settings

List all user settings for the authenticated user.

Common settings include:

autoAddHangouts: Auto-create video meetings
dateFieldOrder: Date format order (MDY, DMY, YMD)
defaultEventLength: Default event duration in minutes
format24HourTime: Use 24-hour time format
hideInvitations: Hide invitations
hideWeekends: Hide weekends in calendar view
locale: User's locale
showDeclinedEvents: Show events the user declined
timezone: User's time zone
weekStart: First day of the week (0=Sunday, 1=Monday, 6=Saturday)

Args:

maxResults: Maximum settings to return
pageToken: Token for pagination
format: Response format

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pageToken": {
      "type": "string",
      "description": "Page token"
    },
    "maxResults": {
      "type": "integer",
      "minimum": 1,
      "description": "Max results"
    }
  }
}

googlecalendar_get_setting

Get a specific user setting.

Common setting IDs:

autoAddHangouts
dateFieldOrder
defaultEventLength
format24HourTime
hideInvitations
hideWeekends
locale
showDeclinedEvents
timezone
weekStart

Args:

settingId: Setting identifier
format: Response format

{
  "type": "object",
  "required": [
    "settingId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "settingId": {
      "type": "string",
      "description": "Setting ID"
    }
  }
}