Sync events across every device and time zone in real time with Google Calendar MCP.
What is Google Calendar MCP?
The Google Calendar MCP node gives you AI-powered access to the Google Calendar API. Describe the scheduling task you need, and the node automatically turns your prompt into the correct API call.What Can It Do for You?
- Pull upcoming events to power reminders or dashboards
- Create meetings automatically from form submissions or messages
- Update or cancel events without opening your calendar
- Check free slots to build smart scheduling workflows
Available Tools
Tool | What It Does | Example Use |
---|---|---|
List Events | Retrieve events in a calendar for a specific date or time range | ”List events on my primary calendar between 2025-06-01 and 2025-06-07. Return event id, summary, start, and end.” |
Create Event | Add a new event to any Google Calendar you have access to | ”Create a 30-minute meeting titled ‘Project Kickoff’ on 2025-06-04 at 10:00 AM PST with description ‘Initial sync’. Return event id and hangoutLink.” |
Update Event | Modify an existing event’s details | ”Update event id 1l2k3m4n so the start time is 2:00 PM PST. Return summary, updated start, and attendees.” |
Delete Event | Remove an event | ”Delete event id d9f8g7h6 on my primary calendar and confirm deletion status.” |
Update Attendee Status | Change an attendee’s response (accepted, tentative, declined) | “Set attendee alice@example.com to accepted for event id 1l2k3m4n. Return attendee status.” |
Check Free Slots | Find available time blocks within a calendar | ”Check free slots on my primary calendar on 2025-06-05 between 9 AM and 5 PM PST, 30-minute windows. Return start and end of each slot.” |
How to Use
1
Create Your Google Calendar MCP Node
Go to your node library, search for Google Calendar, and click “Create a node with AI”
2
Add Your Prompt
Drag the Google Calendar MCP node to your canvas and add your prompt in the text box.
3
Test Your Node
Run the node to see the results. If it works as expected, you’re all set! If you run into issues, check the troubleshooting tips below.
4
Save and Reuse
Once your Google Calendar MCP node is working, save it to your library. You can now use this customized node in any workflow.
Example Prompts
Here are some prompts that work well with Google Calendar MCP: View Schedule:For best results, start with a single, precise action. Once that prompt works, duplicate the node and tweak the prompt for variations instead of packing multiple commands into one request.
Troubleshooting
If your Google Calendar MCP node isn’t working as expected, try these best practices:Keep Prompts Simple and Specific
- Good: “List events on June 5th between 9 AM and 5 PM PST. Return summary and start.”
- Less Efficient: “List my events for next week, then create a new event for any empty slot and invite
xyz@domain.com
.”
While the less efficient example might work, it’s more efficient to break it into separate nodes. Google Calendar MCP works best with focused, single-action prompts.
Match What Google Calendar Can Do
- Good: “Delete event id 123abc on my primary calendar.”
- Bad: “Delete event id 123abc and update my Slack status to ‘Meeting canceled’.”
Google Calendar MCP excels at calendar management. For Slack updates, use a separate Slack node.
Break Complex Tasks Into Steps
Instead of trying to do everything in one prompt (which might cause timeouts or confusion):1
Step 1: Check Free Slots
Check free slots on my primary calendar next week, 30-minute windows. Return start and end.
2
Step 2: Create Meetings
Create an event titled “Client Call” at each provided start time and invite the given email. Return event id and start.
3
Step 3: Send Emails
Send an email via Gmail Sender to each client with their meeting details using the returned event id and start time.
In your workflow, connect these nodes sequentially. The free slot output from Step 1 feeds into Step 2, and the event ids from Step 2 feed into Step 3.
Focus on Data Retrieval
Google Calendar MCP is great at getting information from your calendars. For analysis or content creation, connect it to other nodes. Example:- Good prompt: “List events next Monday and return summary and duration.”
- Bad prompt: “List events next Monday and write a detailed summary of each meeting for a newsletter.”
Use Ask AI to write summaries after the Calendar data is retrieved. Keeping tasks separate speeds up execution.
Troubleshooting Node Creation
Empty Outputs
Empty Outputs
In the node creation window, click “Request changes” and ask the AI to add debug logs and verify the API response.
Incorrect Results
Incorrect Results
In the node creation window, click “Request changes” and describe what you expected versus what you received.
Errors
Errors
First click “Fix with Gummie”. If multiple attempts fail, simplify your prompt or contact support.
Iterate with Request Changes
Iterate with Request Changes
MCP node creation often requires a few tweaks. Use “Request changes” (in the node creation window) to refine filters, output fields, or pagination.
Need More Help?
- Watch What are MCP Nodes video tutorial
- Check out MCP Best Practices in Gumloop University
- Join the Gumloop Community for support
- View the Google Calendar MCP setup guide for Claude and Cursor
- Contact support at support@gumloop.com