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 thesend_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