Google Calendar MCP server

Connect Google Calendar to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Google Calendar MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the get event tool in Google Calendar
  • Use the manage calendar tool in Google Calendar
  • Use the delete event tool in Google Calendar
  • Use the update event tool in Google Calendar
  • Use the get colors tool in Google Calendar
  • Use the find free/busy tool in Google Calendar

How teams use Google Calendar with agents

Calendar is the integration that makes an assistant feel useful day to day. It checks availability across people, books and moves meetings, and answers what is coming up without anyone opening the app.

Find a time

Check free and busy blocks across several people's calendars and propose slots that work for everyone.

Book and reschedule

Create events with attendees and a description, or move a recurring meeting when plans change.

Daily briefing

List the day’s events with attendees, so the agent can pull related email or notes for each meeting.

Calendar sharing

Share a team or resource calendar and review who already has access to it.

Tools to start with

  • Find Free/Busy: Returns busy blocks for many calendars in one request.
  • Quick Add Event: Creates an event from a plain sentence like "Lunch Friday 1pm".
  • Batch Modify Events: Moves or updates several events together.

Sign-in and permissions

Calendar uses OAuth on each person's account. Google classes the calendar scopes as sensitive, and free/busy lookups only return detail for calendars the person is allowed to see.

Sign-in options on Metorial: OAuth.

Supported Tools

get_event

Get Event

Retrieve the full details of a specific event by its ID, including attendees, recurrence, conference data, and all metadata.

manage_calendar

Manage Calendar

Create, update, or delete a secondary calendar. Can also subscribe to, update the display settings of, or unsubscribe from calendars on the user's calendar list. Use the **action** field to select the operation.

delete_event

Delete Event

Permanently delete an event from a Google Calendar. For recurring events, this deletes the entire series unless a specific instance ID is provided.

update_event

Update Event

Update an existing Google Calendar event. Only the provided fields will be modified; all other fields remain unchanged. Can also be used to **move an event** to a different calendar by specifying destinationCalendarId.

get_colors

Get Colors

Retrieve the available calendar and event color definitions used in Google Calendar. Returns color IDs with their background and foreground hex values. Use these IDs when setting colors on events or calendars.

find_free_busy

Find Free/Busy

Query the free/busy availability for one or more calendars over a given time range. Returns busy time slots without exposing event details. Useful for finding open meeting times and checking availability.

list_events

List Events

List events from a Google Calendar with flexible filtering options. Supports time range filtering, text search, pagination, and sorting. Use **"primary"** as the calendarId to list events from the user's primary calendar.

list_calendars

List Calendars

List all calendars on the user's calendar list, including their primary calendar, subscribed calendars, and shared calendars. Returns calendar metadata including access role, color, and visibility settings.

manage_sharing

Manage Sharing

Manage access control (sharing permissions) on a calendar. List current permissions, grant access to users/groups, update roles, or revoke access.

create_event

Create Event

Create a new event on a Google Calendar. Supports timed events, all-day events, recurring events, attendees, conferencing (Google Meet), reminders, and more. Use **"primary"** as the calendarId to create events on the user's primary calendar.

quick_add_event

Quick Add Event

Create an event using natural language text, just like the "Quick Add" feature in the Google Calendar UI. Google parses the text to extract the event title, date, time, and location automatically.

respond_to_event

Respond to Event

Accept, decline, or tentatively accept a Google Calendar invitation without replacing the event's attendee list.

get_settings

Get Settings

Retrieve one Google Calendar user setting or list the settings explicitly stored for the authenticated user.

batch_modify_events

Batch Modify Events

Create, update, or delete multiple Google Calendar events in one tool call. Operations run sequentially and each returns its own success or error result.

list_calendar_sharing

List Calendar Sharing

List the sharing rules for a Google Calendar, including each rule's access role and user, group, domain, or public scope.

get_calendar

Get Calendar

Retrieve the properties of a Google Calendar, including its title, description, time zone, and conferencing options.

Connect Google Calendar to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Google Calendar in Metorial. In your Metorial portal, enable the Google Calendar MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Google Calendar tools.

Run Google Calendar through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Google Calendar and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Google Calendar tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Google Calendar

Microsoft Outlook

Send, read, reply to, forward, and manage email messages in user mailboxes. Organize messages into folders, apply categories, flags, and importance levels. Manage file and item attachments. Create, update, delete, and respond to calendar events and meetings. Find available meeting times, manage attendees, handle recurrence, and work with shared or delegated calendars. Create, read, update, and delete contacts, organize them into contact folders, and manage contact photos. Manage tasks and task lists via Microsoft To Do, including due dates, reminders, recurrence, and checklist items. Support for Focused Inbox, @-mentions, mail tips, send-on-behalf, and send-as capabilities.

Calendly

List, retrieve, and cancel scheduled events. Book meetings programmatically on behalf of invitees using available time slots. Retrieve event types and their configurations. Query user availability, available time slots, busy times, and availability schedules. Create single-use scheduling links with optional overrides. List and manage invitees, mark no-shows, and access custom question responses and UTM tracking data. Manage organization memberships, invite or remove users. Retrieve routing form configurations and submissions. Subscribe to webhooks for new bookings, cancellations, and routing form submissions.

Google Meet

Create and manage Google Meet meeting spaces, configure access settings, moderation modes, and auto-artifacts like recordings and transcripts. Add, list, and remove space members with roles such as co-host. Retrieve conference records including participant details, join/leave times, and session history. Access meeting artifacts including recording metadata, transcript entries with speaker and timestamp data, and smart notes.

Savvycal

Create, manage, and cancel scheduled events via shareable scheduling links. List and create scheduling links with configurable durations, custom fields, and availability settings. Manage automated workflows with actions and rules attached to scheduling links. Register and manage webhooks for real-time notifications on event lifecycle changes, attendee updates, meeting poll responses, and workflow triggers. Retrieve user information and supported time zones. Supports paid event checkout tracking, meeting polls, and custom event metadata.

Microsoft Teams

Send, read, edit, and delete messages in Microsoft Teams channels and chats, with @mentions. Create and manage teams, channels, members, and tags. Schedule and look up online meetings, read user presence, and manage Shifts schedules. Connect a Teams bot to receive and reply to messages in chats and channels.

Fireflies

Record, transcribe, and analyze meeting conversations from platforms like Zoom, Google Meet, and Webex. Retrieve, search, and manage meeting transcripts with AI-generated summaries, action items, sentiment analysis, and keywords. Upload audio files for transcription. Ask questions about meetings using the AskFred AI assistant. Add a bot to live meetings for automatic recording, pause and resume recordings, and create live action items or soundbites. Manage users and teams, organize meetings into channels, and query contacts.

Technical notes for Google Calendar

Create, read, update, and delete calendar events and calendars. Manage attendees, recurring events, and reminders. Check free/busy availability for scheduling. Share calendars and control access permissions. Create events from natural language text with quick add. Manage special event types like focus time, out of office, and working location. Subscribe to or remove calendars from a user's calendar list. Sync calendar changes incrementally.

Frequently asked questions

Common questions about connecting Google Calendar to AI agents with Metorial.

  1. How many tools does the Google Calendar MCP server have?
    The Google Calendar MCP server exposes 16 tools, including Get Event, Manage Calendar, Delete Event. Each one is governed and traced through Metorial.
  2. Yes. Google Calendar has 2 triggers you can use to start workflows from Google Calendar events.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Google Calendar MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Google Calendar and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Google Calendar MCP server yourself or use the hosted gateway.

Connect Google Calendar to production AI agents

See how Metorial gives your team governed access to Google Calendar, with tracing and security controls built in.