← Files get-fableARCHIVED FILE
assets/mcp-servers/google-calendar.md
26.2 KB · Oct 2, 2026 · 00:30 UTC
<!-- MCP server: Google Calendar | captured 2026-07-16, Claude Code 2.1.211 -->
# Google Calendar (MCP server)
## Tools (8)
### create_event
Creates an event on the given calendar.
```json
{
"type": "object",
"properties": {
"addGoogleMeetUrl": {
"description": "Optional. Create and add a Google Meet URL. Default: `false`.",
"type": "boolean"
},
"allDay": {
"description": "Optional. Whether the event spans the entire day. If true, start/end times are treated as midnight.",
"type": "boolean"
},
"attachments": {
"description": "Optional. File attachments.",
"items": {
"$ref": "#/$defs/Attachment"
},
"type": "array"
},
"attendeeEmails": {
"deprecated": true,
"description": "Optional. Deprecated: use `attendees` instead.",
"items": {
"type": "string"
},
"type": "array"
},
"attendees": {
"description": "Optional. Attendees of the event. For events that are created on the user's primary calendar with at least one other attendee, the current user will automatically be added as an attendee if not already included.",
"items": {
"$ref": "#/$defs/Attendee"
},
"type": "array"
},
"availability": {
"description": "Optional. Availability setting.",
"enum": [
"AVAILABILITY_UNSPECIFIED",
"AVAILABILITY_BUSY",
"AVAILABILITY_FREE"
],
"type": "string",
"x-google-enum-descriptions": [
"Default. Treated as BUSY.",
"Blocks time on calendar.",
"Does not block time."
]
},
"calendarId": {
"description": "Optional. Id of the calendar to create the event on. Email address - can be resolved using `list_calendars`. Default: primary calendar.",
"type": "string"
},
"colorId": {
"description": "Optional. The color of the event. This is an ID referring to an entry in the calendar's color palette. Event color ID (string `1`-`11`): * 1: Lavender * 2: Sage * 3: Grape * 4: Flamingo * 5: Banana * 6: Tangerine * 7: Peacock * 8: Graphite * 9: Blueberry * 10: Basil * 11: Tomato.",
"type": "string"
},
"description": {
"description": "Optional. Description. Can contain HTML.",
"type": "string"
},
"endTime": {
"description": "Required. End time (ISO 8601, e.g. '2026-04-30T11:00:00Z').",
"type": "string"
},
"eventType": {
"description": "Optional. Type of the event.",
"enum": [
"EVENT_TYPE_UNSPECIFIED",
"DEFAULT",
"OUT_OF_OFFICE",
"FOCUS_TIME",
"WORKING_LOCATION",
"BIRTHDAY",
"FROM_GMAIL"
],
"type": "string",
"x-google-enum-descriptions": [
"Treated as DEFAULT.",
"Regular event. Default value.",
"Out-of-office event.",
"Focus-time event.",
"Working location event.",
"Special all-day event with an annual recurrence.",
"Event from Gmail. This type of event cannot be created."
]
},
"googleMeetUrl": {
"description": "Optional. Specific Google Meet URL or meeting ID. Overrides add_google_meet_url.",
"type": "string"
},
"guestPermissions": {
"$ref": "#/$defs/GuestPermissions",
"description": "Optional. Guest permissions."
},
"location": {
"description": "Optional. Location.",
"type": "string"
},
"notificationLevel": {
"description": "Optional. Which email notification should be sent for this event update.",
"enum": [
"NOTIFICATION_LEVEL_UNSPECIFIED",
"NONE",
"EXTERNAL_ONLY",
"ALL"
],
"type": "string",
"x-google-enum-descriptions": [
"Default. Treated as ALL.",
"No notifications.",
"External attendees only.",
"All attendees."
]
},
"overrideReminders": {
"description": "Optional. Reminders override, replacing calendar defaults.",
"items": {
"$ref": "#/$defs/Reminder"
},
"type": "array"
},
"recurrenceData": {
"description": "Optional. Recurrence rules as RRULE, RDATE, or EXDATE strings (per RFC 5545).",
"items": {
"type": "string"
},
"type": "array"
},
"startTime": {
"description": "Required. Start time (ISO 8601, e.g. '2026-04-30T10:00:00Z').",
"type": "string"
},
"summary": {
"description": "Required. Title.",
"type": "string"
},
"timeZone": {
"description": "Optional. IANA Time Zone Database name (e.g., 'America/Los_Angeles'). Default: the user's primary time zone. Overrides offsets in start_time or end_time.",
"type": "string"
},
"visibility": {
"description": "Optional. Visibility of the event. Possible values are: * `default` - Uses the default visibility for events on the calendar. Default value. * `public` - The event is public and event details are visible to all readers of the calendar. * `private` - Only event attendees may view event details.",
"type": "string"
},
"workingLocationProperties": {
"$ref": "#/$defs/WorkingLocationProperties",
"description": "Optional. Working location properties (if `eventType` is `WORKING_LOCATION`)."
}
},
"required": [
"summary",
"startTime",
"endTime"
],
"$defs": {
"Attachment": {
"description": "A file attachment for an event.",
"properties": {
"fileUrl": {
"description": "Required. URL link to the attachment.",
"type": "string"
},
"title": {
"description": "Optional. Attachment title.",
"type": "string"
}
},
"required": [
"fileUrl"
],
"type": "object"
},
"Attendee": {
"description": "An event attendee.",
"properties": {
"additionalGuests": {
"description": "Optional. Number of additional guests. Default: 0.",
"format": "int32",
"type": "integer"
},
"comment": {
"description": "Output only. Response comment.",
"readOnly": true,
"type": "string"
},
"displayName": {
"description": "Optional. Name.",
"type": "string"
},
"email": {
"description": "Required. Attendee's email address.",
"type": "string"
},
"id": {
"description": "Output only. Profile ID.",
"readOnly": true,
"type": "string"
},
"optionalAttendee": {
"description": "Optional. Whether attendee is optional. Default: `false`.",
"type": "boolean"
},
"organizer": {
"description": "Output only. Whether attendee is the organizer. Default: `false`.",
"readOnly": true,
"type": "boolean"
},
"resource": {
"description": "Optional. Whether attendee is a resource (e.g. room). Immutable, can only be set when the attendee is initially added. Default: `false`.",
"type": "boolean"
},
"responseStatus": {
"description": "Optional. Response status. Possible values are: * `needsAction` - Attendee has not responded to the invitation (recommended for new events). * `declined` - Attendee has declined the invitation. * `tentative` - Attendee has tentatively accepted the invitation. * `accepted` - Attendee has accepted the invitation.",
"type": "string"
},
"self": {
"description": "Output only. Whether this entry represents the calendar on which this copy of the event appears. Default: `false`.",
"readOnly": true,
"type": "boolean"
}
},
"required": [
"email"
],
"type": "object"
},
"GuestPermissions": {
"description": "Guest permissions for attendees other than the organizer.",
"properties": {
"guestsCanInviteOthers": {
"description": "Optional. Whether guests can invite others.",
"type": "boolean"
},
"guestsCanModify": {
"description": "Optional. Whether guests can modify the event.",
"type": "boolean"
},
"guestsCanSeeGuests": {
"description": "Optional. Whether guests can see other guests.",
"type": "boolean"
}
},
"type": "object"
},
"Reminder": {
"description": "An event reminder.",
"properties": {
"method": {
"description": "Required. Delivery method. Possible values are: * `email` - Reminders are sent via email. * `popup` - Reminders are sent via a UI popup.",
"type": "string"
},
"minutes": {
"description": "Required. Minutes in advance that the reminder is triggered.",
"format": "int32",
"type": "integer"
}
},
"required": [
"method",
"minutes"
],
"type": "object"
},
"WorkingLocationProperties": {
"description": "Properties for working location events.",
"properties": {
"customLocationLabel": {
"description": "Optional. The label for a custom location. Required if type is `CUSTOM_LOCATION`.",
"type": "string"
},
"type": {
"description": "Optional. Working location type.",
"enum": [
"WORKING_LOCATION_TYPE_UNSPECIFIED",
"HOME_OFFICE",
"CUSTOM_LOCATION"
],
"type": "string",
"x-google-enum-descriptions": [
"Unspecified working location type. Will be treated as HOME_OFFICE.",
"Home office.",
"Custom location."
]
}
},
"type": "object"
}
},
"description": "Request message for CreateEvent."
}
```
### delete_event
Deletes an event on the given calendar.
```json
{
"type": "object",
"properties": {
"calendarId": {
"description": "Optional. Id of the calendar containing the event. Email address - can be resolved using `list_calendars`. Default: primary calendar.",
"type": "string"
},
"eventId": {
"description": "Required. The ID of the event to delete.",
"type": "string"
},
"notificationLevel": {
"description": "Optional. Which email notification should be sent for this event update.",
"enum": [
"NOTIFICATION_LEVEL_UNSPECIFIED",
"NONE",
"EXTERNAL_ONLY",
"ALL"
],
"type": "string",
"x-google-enum-descriptions": [
"Default. Treated as ALL.",
"No notifications.",
"External attendees only.",
"All attendees."
]
}
},
"required": [
"eventId"
],
"description": "Request message for DeleteEvent."
}
```
### get_event
Returns a single event on the given calendar.
```json
{
"type": "object",
"properties": {
"calendarId": {
"description": "Optional. Id of the calendar containing the event. Email address - can be resolved using `list_calendars`. Default: primary calendar.",
"type": "string"
},
"eventId": {
"description": "Required. Event ID.",
"type": "string"
}
},
"required": [
"eventId"
]
}
```
### list_calendars
Returns the calendars this user has access to (their calendar list). Use this tool to resolve calendar identifying data (e.g. 'my family calendar') into its corresponding `calendar_id` (email identifier)
```json
{
"type": "object",
"properties": {
"pageSize": {
"description": "Optional. Max results per page. Default 100; max 250.",
"format": "int32",
"type": "integer"
},
"pageToken": {
"description": "Optional. Token specifying which result page to return.",
"type": "string"
}
}
}
```
### list_events
Returns events on the given calendar matching all specified constraints. Time constraints should not be specified unless requested by the user. For open-ended keyword or topic-based searches on the primary calendar, the search_events tool must be used instead.
```json
{
"type": "object",
"properties": {
"calendarId": {
"description": "Optional. Id of the calendar containing the events. Email address - can be resolved using `list_calendars`. Default: primary calendar.",
"type": "string"
},
"endTime": {
"description": "Optional. The upper bound of a time range. Must only be set when a specific timeframe or a time in the past is requested by the user. Must be an ISO 8601 timestamp greater than start_time.",
"type": "string"
},
"eventType": {
"description": "Optional. The event types to return. If empty, only the following event types are returned: `DEFAULT`, `OUT_OF_OFFICE`, `FOCUS_TIME`, `FROM_GMAIL`",
"items": {
"enum": [
"EVENT_TYPE_UNSPECIFIED",
"DEFAULT",
"OUT_OF_OFFICE",
"FOCUS_TIME",
"WORKING_LOCATION",
"BIRTHDAY",
"FROM_GMAIL"
],
"type": "string",
"x-google-enum-descriptions": [
"Treated as DEFAULT.",
"Regular event. Default value.",
"Out-of-office event.",
"Focus-time event.",
"Working location event.",
"Special all-day event with an annual recurrence.",
"Event from Gmail. This type of event cannot be created."
]
},
"type": "array"
},
"eventTypeFilter": {
"deprecated": true,
"description": "Optional. Deprecated: use `event_type` instead.",
"items": {
"type": "string"
},
"type": "array"
},
"fullText": {
"description": "Optional. Free-form case-insensitive search matching title, description, location, or attendees. Matches events containing all query terms verbatim (AND search).",
"type": "string"
},
"orderBy": {
"description": "Optional. The order in which events should be returned. Possible values are: * `default` - Unspecified, but deterministic ordering (default). * `startTime` - Order by start time ascending. * `startTimeDesc` - Order by start time descending. * `lastModified` - Order by last modification time ascending.",
"type": "string"
},
"pageSize": {
"description": "Optional. Max events per page (default 100, max 250). Recommended is 10.",
"format": "int32",
"type": "integer"
},
"pageToken": {
"description": "Optional. Next page token. Use the value from the previous page's nextPageToken.",
"type": "string"
},
"startTime": {
"description": "Optional. The lower bound of a time range. Must only be set when a specific timeframe is requested by the user. Must be an ISO 8601 timestamp less than end_time.",
"type": "string"
},
"timeZone": {
"description": "Optional. Time zone (IANA ID, e.g. `Europe/Zurich`) used to resolve timezone-less dates. Default: calendar's timezone.",
"type": "string"
}
}
}
```
### respond_to_event
Responds to an event on a calendar.
```json
{
"type": "object",
"properties": {
"calendarId": {
"description": "Optional. Id of the calendar containing the event. Email address - can be resolved using `list_calendars`. Default: primary calendar.",
"type": "string"
},
"eventId": {
"description": "Required. The ID of the event to respond to.",
"type": "string"
},
"notificationLevel": {
"description": "Optional. Which email notification should be sent for this event update.",
"enum": [
"NOTIFICATION_LEVEL_UNSPECIFIED",
"NONE",
"EXTERNAL_ONLY",
"ALL"
],
"type": "string",
"x-google-enum-descriptions": [
"Default. Treated as ALL.",
"No notifications.",
"External attendees only.",
"All attendees."
]
},
"responseComment": {
"description": "Optional. The user's comment attached to the response.",
"type": "string"
},
"responseStatus": {
"description": "Required. The new user's response status of the event. Possible values are: * `declined` - The attendee has declined the invitation. * `tentative` - The attendee has tentatively accepted the invitation. * `accepted` - The attendee has accepted the invitation.",
"type": "string"
}
},
"required": [
"eventId",
"responseStatus"
],
"description": "Request message for RespondToEvent."
}
```
### suggest_time
Suggests time periods across one or more calendars.
```json
{
"type": "object",
"properties": {
"attendeeEmails": {
"description": "Required. Attendee emails to find free time for.",
"items": {
"type": "string"
},
"type": "array"
},
"durationMinutes": {
"description": "Optional. Min duration of free slot in minutes. Default: 30.",
"format": "int32",
"type": "integer"
},
"endTime": {
"description": "Required. Query interval end (ISO 8601).",
"type": "string"
},
"preferences": {
"$ref": "#/$defs/Preferences",
"description": "Preferences to find suggested time."
},
"startTime": {
"description": "Required. Query interval start (ISO 8601).",
"type": "string"
},
"timeZone": {
"description": "Optional. Time zone for search times (IANA ID, e.g. `Europe/Zurich`). Default: the offset of start_time, if none then the user's primary time zone.",
"type": "string"
}
},
"required": [
"attendeeEmails",
"startTime",
"endTime"
],
"$defs": {
"Preferences": {
"description": "Preferences for suggested time slots.",
"properties": {
"endHour": {
"description": "Preferred end hour as \"HH:MM\" (24-hour format).",
"type": "string"
},
"excludeWeekends": {
"description": "Exclude weekends.",
"type": "boolean"
},
"pageSize": {
"description": "Max number of slots to return. Default: 5.",
"format": "int32",
"type": "integer"
},
"startHour": {
"description": "Preferred start hour as \"HH:MM\" (24-hour format).",
"type": "string"
}
},
"type": "object"
}
},
"description": "Request message for SuggestTime."
}
```
### update_event
Updates an event on the given calendar.
```json
{
"type": "object",
"properties": {
"addGoogleMeetUrl": {
"description": "Optional. If true, creates or updates a Google Meet URL for the event. Ignored if Meet is disabled.",
"type": "boolean"
},
"addedAttachments": {
"description": "Optional. File attachments to add to the event.",
"items": {
"$ref": "#/$defs/Attachment"
},
"type": "array"
},
"addedAttendeeEmails": {
"deprecated": true,
"description": "Optional. Deprecated: use `added_attendees` instead.",
"items": {
"type": "string"
},
"type": "array"
},
"addedAttendees": {
"description": "Optional. Attendees to add to the event.",
"items": {
"$ref": "#/$defs/Attendee"
},
"type": "array"
},
"allDay": {
"description": "Optional. Changes the event to all-day. If set, start_time/end_time must also be provided.",
"type": "boolean"
},
"availability": {
"description": "Optional. Whether the event blocks time on the calendar.",
"enum": [
"AVAILABILITY_UNSPECIFIED",
"AVAILABILITY_BUSY",
"AVAILABILITY_FREE"
],
"type": "string",
"x-google-enum-descriptions": [
"Default. Treated as BUSY.",
"Blocks time on calendar.",
"Does not block time."
]
},
"calendarId": {
"description": "Optional. Id of the calendar containing the event. Email address - can be resolved using `list_calendars`. Default: primary calendar.",
"type": "string"
},
"colorId": {
"description": "Optional. New color of the event. For a list of color IDs, refer to the documentation of the Event resource.",
"type": "string"
},
"description": {
"description": "Optional. New description. Can contain HTML.",
"type": "string"
},
"endTime": {
"description": "Optional. New end time (ISO 8601).",
"type": "string"
},
"eventId": {
"description": "Required. Event ID.",
"type": "string"
},
"googleMeetUrl": {
"description": "Optional. Allows attaching an existing Google Meet URL or meeting ID to the event. Overrides the value of `addGoogleMeetUrl`.",
"type": "string"
},
"guestPermissions": {
"$ref": "#/$defs/GuestPermissions",
"description": "Optional. Guest permissions settings for this event."
},
"location": {
"description": "Optional. New location.",
"type": "string"
},
"notificationLevel": {
"description": "Optional. Email notification to send for this event update. Default: `ALL`.",
"enum": [
"NOTIFICATION_LEVEL_UNSPECIFIED",
"NONE",
"EXTERNAL_ONLY",
"ALL"
],
"type": "string",
"x-google-enum-descriptions": [
"Default. Treated as ALL.",
"No notifications.",
"External attendees only.",
"All attendees."
]
},
"overrideReminders": {
"description": "Optional. If set, replaces all existing reminders for the event.",
"items": {
"$ref": "#/$defs/Reminder"
},
"type": "array"
},
"removedAttachmentFileUrls": {
"description": "Optional. File attachments to remove from the event.",
"items": {
"type": "string"
},
"type": "array"
},
"removedAttendeeEmails": {
"description": "Optional. The attendees of the event to remove, as email addresses.",
"items": {
"type": "string"
},
"type": "array"
},
"startTime": {
"description": "Optional. New start time (ISO 8601). Preserves duration if updating only start.",
"type": "string"
},
"summary": {
"description": "Optional. New title.",
"type": "string"
},
"timeZone": {
"description": "Optional. IANA Time Zone Database name (e.g., 'America/Los_Angeles'). Default: the user's primary time zone. Overrides offsets in start_time or end_time.",
"type": "string"
},
"visibility": {
"description": "Optional. New visibility of the event. Possible values are: * `default` - Uses the default visibility for events on the calendar. Default value. * `public` - Event details are visible to all readers of the calendar. * `private` - The event is private and only event attendees may view event details.",
"type": "string"
}
},
"required": [
"eventId"
],
"$defs": {
"Attachment": {
"description": "A file attachment for an event.",
"properties": {
"fileUrl": {
"description": "Required. URL link to the attachment.",
"type": "string"
},
"title": {
"description": "Optional. Attachment title.",
"type": "string"
}
},
"required": [
"fileUrl"
],
"type": "object"
},
"Attendee": {
"description": "An event attendee.",
"properties": {
"additionalGuests": {
"description": "Optional. Number of additional guests. Default: 0.",
"format": "int32",
"type": "integer"
},
"comment": {
"description": "Output only. Response comment.",
"readOnly": true,
"type": "string"
},
"displayName": {
"description": "Optional. Name.",
"type": "string"
},
"email": {
"description": "Required. Attendee's email address.",
"type": "string"
},
"id": {
"description": "Output only. Profile ID.",
"readOnly": true,
"type": "string"
},
"optionalAttendee": {
"description": "Optional. Whether attendee is optional. Default: `false`.",
"type": "boolean"
},
"organizer": {
"description": "Output only. Whether attendee is the organizer. Default: `false`.",
"readOnly": true,
"type": "boolean"
},
"resource": {
"description": "Optional. Whether attendee is a resource (e.g. room). Immutable, can only be set when the attendee is initially added. Default: `false`.",
"type": "boolean"
},
"responseStatus": {
"description": "Optional. Response status. Possible values are: * `needsAction` - Attendee has not responded to the invitation (recommended for new events). * `declined` - Attendee has declined the invitation. * `tentative` - Attendee has tentatively accepted the invitation. * `accepted` - Attendee has accepted the invitation.",
"type": "string"
},
"self": {
"description": "Output only. Whether this entry represents the calendar on which this copy of the event appears. Default: `false`.",
"readOnly": true,
"type": "boolean"
}
},
"required": [
"email"
],
"type": "object"
},
"GuestPermissions": {
"description": "Guest permissions for attendees other than the organizer.",
"properties": {
"guestsCanInviteOthers": {
"description": "Optional. Whether guests can invite others.",
"type": "boolean"
},
"guestsCanModify": {
"description": "Optional. Whether guests can modify the event.",
"type": "boolean"
},
"guestsCanSeeGuests": {
"description": "Optional. Whether guests can see other guests.",
"type": "boolean"
}
},
"type": "object"
},
"Reminder": {
"description": "An event reminder.",
"properties": {
"method": {
"description": "Required. Delivery method. Possible values are: * `email` - Reminders are sent via email. * `popup` - Reminders are sent via a UI popup.",
"type": "string"
},
"minutes": {
"description": "Required. Minutes in advance that the reminder is triggered.",
"format": "int32",
"type": "integer"
}
},
"required": [
"method",
"minutes"
],
"type": "object"
}
},
"description": "Request message for UpdateEvent. Fields that are not set will not be updated. LINT.IfChange(UpdateEventRequest)"
}
```
SHA-256: 2db844369ac37407a5cb1cd4d8bf947df5e73e831252b564dfa8340c3b0b65b4