Skip to Content

Google Calendar

Connect to Google Calendar to manage schedules and calendar events.

Key Features

  • Calendar list retrieval
  • Event creation, modification, deletion
  • Event search and retrieval
  • Color management
  • Attendee management
  • Notification settings
  • Recurring schedule management
  • Free/Busy availability checking
  • Automatic Google Meet generation
  • Automatic attendee notifications

Basic Information

Authentication Method

Authenticates using OAuth 2.0.

Required Permissions

  • https://www.googleapis.com/auth/calendar: Full Google Calendar access permission

Supported MCP Tools

Calendar Management Tools

list_calendars

Retrieves list of all available calendars.

list_colors

Retrieves color IDs and meanings that can be used for calendar events.

Event Retrieval Tools

list_events

Retrieves event list from calendar.

search_events

Searches for events in calendar using text query.

get_free_busy

Checks availability of participants’ schedules.

Event Management Tools

create_event

Creates a new calendar event.

  • Automatic organizer addition: Automatically includes primary calendar owner in attendee list
  • Automatic Google Meet generation: Automatically adds video conference link to all events
  • Attendee notifications: Automatically sends notifications to all attendees when creating events

update_event

Updates an existing calendar event.

  • send_updates (optional): Notification control parameter
    • "all" (default): Notify all attendees
    • "externalOnly": Notify only external attendees
    • "none": Do not send notifications

delete_event

Deletes a calendar event.

  • Deletion notifications: Automatically sends notifications to all attendees when deleting events

Usage Examples

For example,

  • When you input “Retrieve today’s schedule from my calendar” as a prompt,
  • The LLM calls the list_events tool through MCP to retrieve the schedule list.
  • Then, it responds in the chat based on the tool call results.

Other examples:

  • When you input “Check available time slots for John and Jane from 11 AM to 1 PM on May 2nd”,
  • The LLM uses the get_free_busy tool to check participants’ availability.
{ "calendars": ["primary", "john@example.com", "jane@example.com"], "time_min": "2025-05-02T11:00:00+09:00", "time_max": "2025-05-02T13:00:00+09:00" }
  • When you input “Update the meeting and only notify external attendees”,
  • The LLM uses the update_event tool with the send_updates: "externalOnly" parameter.

Example Prompt

This is an example prompt to help Google Calendar MCP operation.
Try adding it to the Instruction in MCP Preset.

# Create a Google Meet and Add to Calendar 1. **Participant identification**: Ensure to ask who should be invited if not provided. If an email address is given, use that email directly. If only a name is provided, format it as $name@querypie.com 2. **Meeting date**: If no specific date is provided, default to today's date 3. **Time slot optimization**: Find all available meeting slots (30 minutes to 1 hour duration) when all participants can attend 4. **Recommendation phase**: Provide scheduling suggestions based on availability analysis
Last updated on