Hosted MCP server · #23 most used on Smithery · ✓ verified

Google Calendar

googlecalendar

Create, update, and delete Google Calendar events, list calendars and events, respond to invitations, and find times when everyone is free.

Productivity & PM

Install ↓Smithery ↗

Uses: 16k
Tools: 9
Runs: Hosted
Listed: 12mo ago

Get started

Add it to your agent

npx -y @smithery/cli@latest install googlecalendar --client claude

Swap --client claude for cursor, vscode, windsurf or another client. The CLI asks for any required settings.

claude mcp add --transport http google-calendar https://server.smithery.ai/googlecalendar/mcp

A hosted server: nothing to install. Run /mcp in Claude Code to sign in if it asks.

[mcp_servers.google-calendar]
url = "https://server.smithery.ai/googlecalendar/mcp"

Add to ~/.codex/config.toml.

{
  "mcpServers": {
    "google-calendar": {
      "url": "https://server.smithery.ai/googlecalendar/mcp"
    }
  }
}

Add to ~/.cursor/mcp.json.

{
  "servers": {
    "google-calendar": {
      "type": "http",
      "url": "https://server.smithery.ai/googlecalendar/mcp"
    }
  }
}

Add to .vscode/mcp.json.

gemini mcp add --transport http google-calendar https://server.smithery.ai/googlecalendar/mcp

Saved to .gemini/settings.json.

What it can do

9 tools

Arcade_ListAppsSee the apps the current caller can act on and whether they are connected. Returns each app's id, name, connected state, and (when connec…

See the apps the current caller can act on and whether they are connected. Returns each app's id, name, connected state, and (when connected) the account it is connected as. Call this to answer "what apps do I have?" or when the caller's connection state may have changed since the session started.

GoogleCalendar_CreateEvent11 paramsCreate a new event/meeting/sync/meetup in the specified calendar. Pass `recurrence` to create a repeating event.

Parameter	Type	Description
`summary`	string	The title of the event
`location`	string	The location of the event
`recurrence`	array	Recurrence rules for a repeating event, in RFC 5545 format. Each entry is an RRULE/RDATE/EXDATE line; a bare rule is automatically prefixed with 'RRULE:'. Examples: ['RRULE:FREQ=WEEKLY;BYDAY=MO,WE,FR;
`visibility`	string	The visibility of the event
`calendar_id`	string	The ID of the calendar to create the event in, usually 'primary'.
`description`	string	The description of the event
`end_datetime`	string	The datetime when the event ends in ISO 8601 format, e.g., '2024-12-31T17:30:00'.
`start_datetime`	string	The datetime when the event starts in ISO 8601 format, e.g., '2024-12-31T15:30:00'.
`add_google_meet`	boolean	Whether to add a Google Meet link to the event. Defaults to False.
`attendee_emails`	array	The list of attendee emails. Must be valid email addresses e.g., username@domain.com.
`send_notifications_to_attendees`	string	Should attendees be notified by email of the invitation? (none, all, external_only)

GoogleCalendar_DeleteEvent3 paramsDelete an event from Google Calendar.

Parameter	Type	Description
`event_id`	string	The ID of the event to delete
`calendar_id`	string	The ID of the calendar containing the event
`send_updates`	string	Specifies which attendees to notify about the deletion

GoogleCalendar_FindTimeSlotsWhenEveryoneIsFree5 paramsProvides time slots when everyone is free within a given date range and time boundaries.

Parameter	Type	Description
`end_date`	string	The end date to search for time slots in the format 'YYYY-MM-DD'. Defaults to seven days from the start date. It will search until this date at the time 23:59:59.
`start_date`	string	The start date to search for time slots in the format 'YYYY-MM-DD'. Defaults to today's date. It will search starting from this date at the time 00:00:00.
`email_addresses`	array	The list of email addresses from people in the same organization domain (apart from the currently logged in user) to search for free time slots. Defaults to None, which will return free time slots for
`end_time_boundary`	string	Will return free slots in any given day until this time in the format 'HH:MM'. Defaults to '18:00', which is a usual business hour end time.
`start_time_boundary`	string	Will return free slots in any given day starting from this time in the format 'HH:MM'. Defaults to '08:00', which is a usual business hour start time.

GoogleCalendar_ListCalendars4 paramsList all calendars accessible by the user.

Parameter	Type	Description
`max_results`	integer	The maximum number of calendars to return. Up to 250 calendars, defaults to 10.
`show_hidden`	boolean	Whether to show hidden calendars. Defaults to False
`show_deleted`	boolean	Whether to show deleted calendars. Defaults to False
`next_page_token`	string	The token to retrieve the next page of calendars. Optional.

GoogleCalendar_ListEvents4 paramsList events from the specified calendar within the given datetime range. min_end_datetime serves as the lower bound (exclusive) for an ev…

List events from the specified calendar within the given datetime range. min_end_datetime serves as the lower bound (exclusive) for an event's end time. max_start_datetime serves as the upper bound (exclusive) for an event's start time. For example: If min_end_datetime is set to 2024-09-15T09:00:00 and max_start_datetime is set to 2024-09-16T17:00:00, the function will return events that: 1. End after 09:00 on September 15, 2024 (exclusive) 2. Start before 17:00 on September 16, 2024 (exclusive)

Parameter	Type	Description
`calendar_id`	string	The ID of the calendar to list events from
`max_results`	integer	The maximum number of events to return
`min_end_datetime`	string	Filter by events that end on or after this datetime in ISO 8601 format, e.g., '2024-09-15T09:00:00'.
`max_start_datetime`	string	Filter by events that start before this datetime in ISO 8601 format, e.g., '2024-09-16T17:00:00'.

GoogleCalendar_RespondToEvent4 paramsAccept or decline (RSVP to) a meeting invitation on the authenticated user's behalf. Sets the user's responseStatus for an event they wer…

Accept or decline (RSVP to) a meeting invitation on the authenticated user's behalf. Sets the user's responseStatus for an event they were invited to.

Parameter	Type	Description
`event_id`	string	The ID of the event to respond to. Use the event id from list_events to respond to a single occurrence of a recurring event, or its recurringEventId to respond to the whole series.
`response`	string	The RSVP response: accepted or declined.
`calendar_id`	string	The ID of the calendar containing the event
`send_updates`	string	Should attendees be notified of the response? (none, all, external_only)

GoogleCalendar_UpdateEvent12 paramsUpdate an existing event in the specified calendar with the provided details. Only the provided fields will be updated; others will remai…

Update an existing event in the specified calendar with the provided details. Only the provided fields will be updated; others will remain unchanged. `updated_start_datetime` and `updated_end_datetime` are independent and can be provided separately.

Parameter	Type	Description
`event_id`	string	The ID of the event to update
`updated_summary`	string	The updated title of the event
`updated_location`	string	The updated location of the event
`updated_recurrence`	array	Updated recurrence rules for a repeating event, in RFC 5545 format. Each entry is an RRULE/RDATE/EXDATE line; a bare rule is automatically prefixed with 'RRULE:'. Provide the full set of rules to repl
`updated_visibility`	string	The visibility of the event
`updated_calendar_id`	string	The updated ID of the calendar containing the event.
`updated_description`	string	The updated description of the event
`updated_google_meet`	string	Whether to update the Google Meet link to the event. (none, add, remove)
`updated_end_datetime`	string	The updated datetime that the event ends in ISO 8601 format, e.g., '2024-12-31T17:30:00'.
`attendee_emails_to_add`	array	The list of attendee emails to add. Must be valid email addresses e.g., username@domain.com.
`updated_start_datetime`	string	The updated datetime that the event starts in ISO 8601 format, e.g., '2024-12-31T15:30:00'.
`attendee_emails_to_remove`	array	The list of attendee emails to remove. Must be valid email addresses e.g., username@domain.com.

GoogleCalendar_WhoAmIGet comprehensive user profile and Google Calendar environment information. This tool provides detailed information about the authenticat…

Get comprehensive user profile and Google Calendar environment information. This tool provides detailed information about the authenticated user including their name, email, profile picture, Google Calendar access permissions, and other important profile details from Google services.