Google Calendar MCP. Schedule meetings and manage conflicts from chat.

Q: What is the difference between listevents and searchevents?

listevents pulls all scheduled events for a calendar. searchevents lets you query by text, pulling out specific bookings that mention certain keywords or topics.

Q: How do I find out which calendars are connected using listcalendars?

Running listcalendars returns a full list of all available calendar IDs and names linked to your account. You must use these specific IDs for any subsequent tool calls.

Claude

ChatGPT

Cursor

Gemini

Windsurf

VS Code

JetBrains

Vercel

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

Just plug in your AI agents and start using Vinkius.

Google Calendar MCP Server manages your entire professional schedule. It lets your AI client read every meeting detail, check for time conflicts across multiple users, and book new appointments directly in chat.

You can list all calendars, search past events by keyword, or completely modify an existing booking—all without touching the web interface.

What your AI agents can do

Check free busy

Checks if the calendar is available within a specific time range.

Create event

Schedules and adds a new event to your primary calendar.

Delete event

Cancels or removes an existing calendar entry entirely.

+ 12 more capabilities included

Check Availability

Determines if a specific time slot is free for one or more people.

Create Events

Schedules and adds a new event to your calendar, complete with attendees and duration.

Cancel/Delete Meetings

Removes an existing calendar entry entirely.

List All Calendars

Pulls a list of every calendar associated with your user account.

Find Specific Events

Searches all entries for keywords or criteria, pulling matching event data.

Update Booking Details

Modifies existing events—like changing the location or updating the description.

Ask AI about this MCP

Ask ChatGPT

Ask Claude

Ask Perplexity

Supported MCP Clients

Claude

ChatGPT

Cursor

Gemini

Windsurf

VS Code

JetBrains

Vercel

+ other MCP clients

Free for Subscribers

Waiting for input…

AI Agent

Google Calendar: 12 Tools for Scheduling

Use these tools to manage every aspect of your professional schedule, from checking time slots with `check_free_busy` to modifying existing meetings with `update_event`.

check019d75a8

check free busy

Checks if the calendar is available within a specific time range.

create019d75a8

create event

Schedules and adds a new event to your primary calendar.

delete019d75a8

delete event

Cancels or removes an existing calendar entry entirely.

get019d75a8

get calendar metadata

Retrieves information about a specific, named calendar.

get019d75a8

get event

Gets full details for one specified event ID.

get019d75a8

get settings

Pulls the general configuration and settings for your user calendar.

list019d75a8

list acl

Displays who has access control rights to a specific calendar.

list019d75a8

list calendars

Lists every single calendar account linked under your user profile.

list019e9a98

list event instances

List instances of a recurring event

list019d75a8

list events

Retrieves all upcoming events from a specified calendar for listing.

move019e9a98

move event

Move an event to a different calendar

patch019e9a98

patch event

Partially update an event (e.g., change just the status or attendees)

quick019d75a8

quick add event

Creates an event simply by reading and processing a plain text string input.

search019d75a8

search events

Searches your calendar history or future bookings using a natural language query.

update019d75a8

update event

Modifies an existing event's details, such as time, location, or attendees.

Choose How to Get Started

Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.

Build Your Own

Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.

Import from OpenAPI, Swagger, or YAML specs
Create Agent Skills with progressive disclosure
Deploy to edge with MCPFusion framework
Built in DLP, auth, and compliance on every call
Real time usage dashboard and cost metering
Publish to catalog or keep private

Start building

Make Your AI Do More

Start with Google Calendar, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.

Use this MCP plus 4,700+ others, all in one place
Add new capabilities to your AI anytime you want
Every connection is secured and compliant automatically
Track usage and costs across all your servers
Works with Claude, ChatGPT, Cursor, and more
New servers added to the catalog every week

What you can do with this MCP connector

Listen up. This Google Calendar MCP Server hooks your entire professional schedule right into your AI client. Forget fiddlin' with a web interface; this thing lets your agent handle all the meeting mess inside your chat window.

The Google Calendar MCP Server gives you full control over every calendar linked to your account, letting your agent read details, check for conflicts across multiple people, and book stuff without ya liftin' a finger. You can list every single calendar you got, search past bookings by keywords, or even totally overhaul an existing appointment.

Managing Your Time & Meetings

When it comes to figuring out if you're free, the server lets your agent run check_free_busy to see if a specific calendar is open for any given time slot. If you need to figure out what calendars are even attached to your account, you use list_calendars. You can also pull basic info on a single calendar using get_calendar_metadata, and check who's got access control rights by running list_acl.

If you’re trying to find specific appointments in the past or future, the system lets your agent use search_events, which reads natural language queries across all your bookings. For a full rundown of upcoming events on one calendar, it runs list_events. You can also get detailed information for a single event using get_event once you've got that specific ID.

Booking and Modifying Appointments

Need to book something? Your agent uses quick_add_event to create an appointment just by reading plain text input. For more control, it runs create_event to schedule and add a brand new event to your primary calendar. If you need to update an existing booking—like change the time, location, or who's invited—the agent uses update_event.

You can also completely wipe out an old meeting using delete_event, which cancels or removes any calendar entry entirely.

Advanced Controls & Settings

The server gives your agent ways to read the system itself. It pulls general configuration and settings for your user calendar via get_settings. When it comes to finding out what's happening, you can run list_events against a specified calendar to get all upcoming items. The toolset is built so that your AI client manages every step—it handles the overlaps and sends invites based on whatever instructions you give it.

How Google Calendar MCP Works

1 First, you subscribe to this server and provide your OAuth credentials for Google Workspace/GCP.
2 Next, you tell your AI client exactly what task needs doing—for example, 'Find a 30-minute slot next week when John is free.'
3 The agent executes the necessary tool calls (like check_free_busy), retrieves the data, and reports the outcome directly to you.

The bottom line is: You give the AI client the task; it uses the tools to talk to Google Calendar and gives you the answer.

Who Is Google Calendar MCP For?

Project Managers who get sick of cross-referencing team availability across multiple meeting links. Founders and executives who need to delegate complex scheduling tasks without writing a single email chain. If your job involves coordinating more than two people, this is for you.

Project Manager

Uses check_free_busy to instantly spot team sync anomalies or free slots when planning urgent meetings.

Team Lead / Director

Delegates scheduling back-and-forth using the agent, letting it autonomously run create_event and send invites.

Founder / Executive

Needs to modify a key meeting's details or location (update_event) immediately based on new context without manually logging into Google Calendar.

What Changes When You Connect

Stop guessing if people are free. Use check_free_busy to instantly validate time slots for a team of five, eliminating scheduling ping-pong.
Book meetings in seconds. The quick_add_event tool lets you write 'Sync with Marketing next Tuesday' and get the event created without needing formal parameters.
Handle changes fluidly. If a meeting moves or needs an address update, just run update_event to modify it directly—no manual edits required.
See everything at once. Use list_events to pull all bookings from a specific calendar so you can get a full picture of the week's commitments.
Find that one meeting. Instead of scrolling through months, use search_events with keywords (e.g., 'budget review') and let your agent find it.

Real-World Use Cases

The Overlapping Schedule

A Project Manager needs to book a crucial follow-up meeting, but the primary stakeholder is booked at 2 PM. They ask their agent: 'Check for availability next week after 10 AM.' The agent runs check_free_busy and finds three open slots, allowing the PM to select one instantly using create_event.

The Last-Minute Move

A team member's meeting location changes from 'Room A' to a client site. Instead of manually editing the invite, they tell their agent: 'Change 'Q3 Sync' location to 123 Main Street.' The agent uses update_event and cascades the change across all invites.

The Quick Follow-Up

A founder needs a quick sync with an external vendor next week. They simply type: 'Book 30 minutes with Acme Corp on Friday.' The agent uses quick_add_event to generate and send the invite without needing specific date/time inputs.

The Historical Deep Dive

An executive needs proof of last quarter's meetings. They ask their agent: 'Show me all events mentioning 'board review' in Q2.' The agent runs search_events and pulls a clean list, saving hours of manual searching.

The Tradeoffs

Assuming Time Slots are Open

Telling the AI: 'Schedule a team meeting for tomorrow at 10 AM.' The agent tries to run create_event and fails, but you don't know why it failed.

→ Always check first. Before scheduling, use check_free_busy with the required time range. If that confirms a clear slot, then proceed with create_event. This prevents booking conflicts.

Modifying an Unknown Event

Telling the AI: 'Change the description of the big client meeting.' The agent has no ID and can't find or update anything, leaving you hanging.

→ You must locate the event first. Use search_events to pinpoint the correct booking, get its specific details (like an Event ID), then use that ID with update_event.

Listing Without Scope

Asking the agent to 'show me my meetings' without specifying which calendar. The system might pull data from the wrong account, giving you bad info.

→ Always specify scope. Start by using list_calendars if you aren't sure which calendar holds the event, then use list_events on the correct one.

When It Fits, When It Doesn't

Use this server if your primary bottleneck is coordinating time and people across multiple calendars. You need a system that reliably handles finding open slots (check_free_busy), making changes (update_event), or creating bookings from simple natural language prompts (quick_add_event).

Don't use it if you only need to read static data, like pulling raw contact lists (use a different tool/service). If your core problem is data retrieval (e.g., getting detailed metadata about the calendar itself), focus on get_calendar_metadata or list_calendars. However, for any action that involves time—booking, canceling, modifying—this set of tools handles it end-to-end.

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Google Calendar. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

VINKIUS INFRASTRUCTURE

Cloud Hosted

Managed infra

V8 Isolated

Sandboxed per request

Zero-Trust Proxy

No stored credentials

DLP Enforced

Policy on every call

GDPR Compliant

EU data residency

Token Compression

~60% cost reduction

How we secure it →

Works with Claude, ChatGPT, Cursor, and more

The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.

This server provides 15 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.

Available Capabilities

check_free_busy create_event delete_event get_calendar_metadata get_event get_settings list_acl list_calendars list_event_instances list_events move_event patch_event quick_add_event search_events update_event

Coordinating a meeting across three different calendars is always an administrative nightmare.

Right now? You're copy-pasting time zones. You check Outlook, then Google Calendar, then Slack—just to make sure nobody double-booked themselves. Then you have to send out a follow-up email just confirming the final slot and linking everything up.

With this MCP server, your agent handles all that friction. You tell it what you need; it runs `check_free_busy` against multiple accounts and hands back clear options. It’s done in conversation.

Google Calendar MCP Server: Manage bookings instantly.

The manual steps that disappear are the 'search for availability' loop, the cross-checking of conflicting time slots, and the subsequent 'update all invites' process. You never have to manually change a single invite link again.

It’s simple: you give the command, and it performs complex scheduling logic using tools like `create_event` or `delete_event`. That’s all.

Common Questions About Google Calendar MCP

How do I use the `quick_add_event` tool? +

Just send a plain text prompt describing the event. The agent processes natural language input and uses the underlying Google API to book the time automatically.

Can I check for conflicts using `check_free_busy`? +

Yes, that's exactly what it does. You provide a starting range and an ending range, and the tool tells you if any booked times overlap with your request.

What is the difference between `list_events` and `search_events`? +

list_events pulls all scheduled events for a calendar. search_events lets you query by text, pulling out specific bookings that mention certain keywords or topics.

How do I change an event's time using `update_event`? +

You must first find the event (using its ID or a search query), and then tell the agent to run update_event with the new parameters, like the updated date.

How do I use `create_event` to schedule a series of meetings? +

You pass an array of event parameters to create multiple entries. The server processes these sequentially, guaranteeing that all specified time slots and attendees get booked correctly.

What happens when I use the `delete_event` tool? +

Deleting an event automatically sends a cancellation payload to all listed participants. This ensures everyone receives notice right away that the meeting slot is officially cleared from their calendar.

How do I find out which calendars are connected using `list_calendars`? +

Running list_calendars returns a full list of all available calendar IDs and names linked to your account. You must use these specific IDs for any subsequent tool calls.

How does the `list_acl` tool help me check access permissions? +

This tool pulls the Access Control List rules for a given calendar ID. It shows exactly who has read, write, or delete permission before you try to modify anything.

Can it automatically generate meet links when booking? +

Yes. When building the create_event request, the agent can structure event metadata that explicitly flags conferencing generation. You get a Google Meet URL seamlessly inside the payload.

How does the tool handle multiple calendars (e.g. personal and work)? +

It requires querying the primary or specified secondary calendar IDs. By default, it operates on 'primary'. You can command the agent to use list_calendars to pick and choose exactly which specific agenda it targets.

Will the AI delete historical meetings completely if I ask it? +

While specific delete_event tools track individual IDs, bulk deletions and catastrophic operations are architecturally suppressed for safety. Removing isolated tasks works strictly one-by-one by direct matching.

View all recipes →