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