# Google Calendar MCP for AI Agents AI Agent Connect > Google Calendar MCP lets your AI agent manage your schedule directly. It can find meetings, book new appointments, and fix conflicts without you having to swap between tabs. It turns your calendar into an actionable database for your agent to handle the logistics of your day. ## Overview - **Category:** industry-titans - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_zbNn8A5aA3OLeAkydmVfzHYZvJZ3KiufKMgE8IGv/ai-agent-connect - **Tags:** time-management, meeting-scheduling, event-coordination, availability-tracking, agenda-management ## Description This Google Calendar MCP connects your schedule to any AI agent and removes the friction of manual booking. Managing a packed calendar usually involves a constant back-and-forth of "Are you free at 2 PM?" and manually moving blocks around when things go sideways. This changes that by giving your agent the ability to see and touch your calendar data directly. Instead of copy-pasting links or checking your availability manually, you can just tell your agent to find a slot for a sync or move a meeting that ran over. It handles the heavy lifting of looking through past and future entries, identifying overlaps, and making the actual edits. When you connect this through the Vinkius catalog, your agent becomes a true scheduling partner that can handle the admin side of your day. It's about moving from "let me check my calendar and get back to you" to "it's already booked." You can ask it to summarize what's on your plate for the day, find specific past meetings to recall what was discussed, or quickly add a new appointment from a rough note. It removes the friction of switching tabs and lets your agent do the tedious work of coordinating your time. You can manage multiple calendars at once, ensuring that your personal commitments and professional obligations never collide. This gives you a clear view of your day while the AI handles the logistics of keeping everything on track. It turns your calendar from a static list of events into a dynamic tool that works for you. ## Tools ### get_settings View your current calendar configuration. This provides the agent with the context of your user settings. ### list_acl See who has permission to view or edit a calendar. This is helpful for checking shared access rules. ### list_calendars See every calendar tied to your account. This gives the agent a full view of your available schedules. ### list_event_instances See all occurrences of a recurring meeting. This is useful for tracking series of syncs. ### list_events Get a list of upcoming meetings from a specific calendar. This helps you see what's coming up next. ### move_event Switch an existing appointment to a different calendar. Use this to reassign meetings between accounts. ### patch_event Update just one part of a meeting, like the status. This allows for small changes without rewriting the whole event. ### quick_add_event Create a meeting from a simple text string. This is the fastest way to get a rough idea onto your calendar. ### search_events Find meetings using a text search query. Use this to find past projects or specific keywords in your history. ### update_event Change any detail of an existing appointment. This lets you fully modify a meeting's time, title, or guests. ### check_free_busy See if a specific time slot is open or taken. This prevents you from double booking yourself. ### create_event Add a new appointment to your schedule. Your agent can do this based on your voice or text commands. ### delete_event Remove a meeting from your calendar. Use this to quickly cancel appointments that no longer need to happen. ### get_calendar_metadata Pull basic info about a specific calendar. This helps the agent understand the scope of your accounts. ### get_event Pull all the details for one specific meeting. Use this to see exactly who is invited and where it's held. ## Prompt Examples **Prompt:** ``` Check if I'm free next Thursday afternoon for a 1-hour deep dive. ``` **Response:** ``` Checking your schedule for next Thursday afternoon... **Availability Results:** - 13:00 - 14:00: **Available** - 14:00 - 15:00: **Busy** (Internal Sync) - 15:00 - 16:00: **Available** You have two clear windows. Would you like me to book the 1:00 PM slot or the 3:00 PM slot? ``` **Prompt:** ``` Book a 30-minute coffee chat with j.doe@company.com for Friday at 10 AM. ``` **Response:** ``` Done. I've scheduled the **Coffee Chat** for Friday at 10:00 AM. **Details:** - **Duration:** 30 minutes - **Guest:** j.doe@company.com - **Status:** Confirmed I've sent the calendar invite with the meeting link included. ``` **Prompt:** ``` Move my 'Weekly Sync' from Monday to Wednesday at the same time. ``` **Response:** ``` I've successfully moved the **Weekly Sync**. **Old Time:** Monday, 10:00 AM **New Time:** Wednesday, 10:00 AM The event has been updated on your calendar and all participants have been notified. ``` ## Capabilities ### Book new appointments Your agent can schedule new meetings by creating entries from your text instructions. ### Identify schedule overlaps The agent scans your calendar to find conflicts and suggest better times. ### Move existing meetings You can tell your agent to shift an appointment to a different day or calendar. ### Retrieve meeting details The agent pulls specific information like attendees, locations, and links from any event. ### Check availability The agent verifies if a specific time block is open before you commit to a meeting. ### Update event details Your agent can modify parts of a meeting, like the description or the guest list. ## Use Cases ### Finding a team sync time A project manager asks the agent to find a 1-hour gap for four people next week. The agent uses `check_free_busy` and then `create_event` to book the best slot. ### Fixing a meeting overlap A user notices a lunch was booked over a meeting. They tell the agent to move the lunch, and it uses `move_event` to shift it to a clear spot. ### Recalling past project details A founder needs to know what was decided in a meeting last month. The agent uses `search_events` to find the 'Q3 Review' and pulls the summary. ### Adding a quick note to the calendar You tell your agent, 'Put a coffee chat with Sarah on Friday at 10 AM.' The agent uses `quick_add_event` to put it on your schedule immediately. ## Benefits - Stop manual booking. Use `create_event` to let your agent book meetings while you work on other things. This means you don't have to leave your chat or email to handle the logistics of finding a time and sending out the formal invitation. - Resolve conflicts instantly. Use `check_free_busy` to find gaps and `move_event` to fix overlaps without manual dragging. Your agent can spot a double booking before it happens and suggest a new time, saving you from the headache of rescheduling at the last minute. - Faster information retrieval. Use `search_events` to find specific past meetings in seconds instead of scrolling through months of data. This lets you quickly recall details from a previous project sync without hunting through your history. - Precise updates. Use `patch_event` to change just the attendee list or status without rewriting the whole invite. It allows for surgical changes to your schedule, ensuring that you only modify what's necessary while keeping the rest of the event data intact. - Better visibility. Use `list_calendars` to see your entire work life across multiple accounts in one place. This gives your agent a full picture of your availability, making it much easier to coordinate complex schedules that span across different teams or projects. ## How It Works The bottom line is your AI gets a direct line to your schedule so it can manage your time for you. 1. Subscribe to the Google Calendar MCP on Vinkius. 2. Provide your Workspace or GCP OAuth credentials to connect your account. 3. Give your AI client permission to read and write to your calendars. ## Frequently Asked Questions **Can the Google Calendar MCP book meetings for me?** Yes. It allows your agent to create new appointments and send invites directly to your guests based on your instructions. **How does the Google Calendar MCP handle meeting conflicts?** The agent can scan your schedule to identify overlaps and suggest alternative times that are free for everyone involved. **Can I use the Google Calendar MCP to see my work and personal calendars?** Yes. It can list all calendars tied to your account, giving your agent a full view of your total availability. **Does the Google Calendar MCP support recurring events?** It does. Your agent can view instances of recurring meetings and manage them just like one-time events. **Can I use the Google Calendar MCP to update meeting locations?** Yes. You can tell your agent to modify specific details like the location, description, or attendee list for any existing event. **How do I give the Google Calendar MCP permission to see my events?** You provide your Google Workspace or GCP OAuth credentials during the setup process on Vinkius to grant the necessary access. **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.