Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.gumloop.com/llms.txt

Use this file to discover all available pages before exploring further.

Google Calendar is Google’s scheduling service for managing events and appointments. The Google Calendar MCP server lets you create, update, and search events using natural language.

​
What Can It Do?

  • List and search events for any date or time range with detailed attendee information, filterable by event type
  • Create meetings with attendees and details, including special event types like Out of Office, Focus Time, and Working Location
  • Auto-generate Google Meet links when creating events
  • Update or cancel events without opening your calendar
  • Update attendee responses for any event
  • Check free slots for smart scheduling
  • Manage attendees by adding or removing them from events
  • List calendars accessible to the user
  • Move events between calendars
  • View recurring event instances with date filtering
  • Manage access control rules for calendar sharing

​
Where to Use It

Add Google Calendar as a tool to any agent. The agent can then manage your schedule conversationally, choosing the right actions based on context. To add an MCP tool to your agent:
  1. Open your agent’s configuration
  2. Click Add tools → Connect an app with MCP
  3. Search for the integration and select it
  4. Authenticate with your account
You can control which tools your agent has access to. After adding an integration, click on it to enable or disable specific tools based on what your agent needs.

​
In Workflows (Via Agent Node)

For automated pipelines, use an Agent Node with Google Calendar tools. This gives you the flexibility of an agent within a deterministic workflow.

​
As a Custom MCP Node

You can also create a standalone MCP node for a specific action. This generates a reusable node that performs one task, useful when you need the same operation repeatedly in workflows.
To create a custom MCP node:
  1. Go to your node library and search for the integration
  2. Click Create a node with AI
  3. Describe the specific action you want (e.g., “Create a 30-minute meeting tomorrow”)
  4. Test the node and save it for reuse
Custom MCP nodes are single-purpose by design. For tasks that require multiple steps or dynamic decision-making, use an agent instead.

​
Available Tools

ToolDescription
List EventsRetrieve events for a date range (includes attendee details with response status). Supports filtering by event type: default, Out of Office, Focus Time, Working Location, Birthday, and from Gmail.
Get EventGet a single event by ID with full details
Create EventAdd a new event to your calendar (optionally auto-generates a Google Meet link via create_conference). Supports creating Out of Office, Focus Time, and Working Location events with type-specific properties.
Update EventModify an existing event. Supports updating event type properties such as Out of Office, Focus Time, and Working Location.
Delete EventRemove an event
Update Attendee StatusChange an attendee’s response status for an event
Manage AttendeeAdd or remove an attendee from an event
Check Free SlotsFind available time blocks
List CalendarsList all calendars accessible to the user
Move EventMove an event to a different calendar
List Recurring Event InstancesList individual occurrences of a recurring event
List ACL RulesList access control rules for a calendar
Manage ACL RuleAdd or remove an access control rule on a calendar

​
Example Prompts

Use these with your agent or in the Agent Node: View schedule: 
What meetings do I have tomorrow?
Create a meeting: 
Schedule a 45-minute meeting with sarah@company.com next Tuesday at 2pm
Create a meeting with a Google Meet link: 
Schedule a 30-minute meeting with the eng team tomorrow at 10am and add a Google Meet link
Check availability: 
Find free 30-minute slots on Friday between 9am and 5pm
Update a meeting: 
Move my 10am meeting to 2pm
Cancel a meeting: 
Delete my meeting with John tomorrow
Set Out of Office: 
Create an out of office event for next Friday with the auto-decline message "On PTO"
Block focus time: 
Block 2 hours of focus time tomorrow morning starting at 9am
Filter by event type: 
Show me all out of office events on my calendar this month
Check attendee responses: 
Who has accepted the team standup meeting tomorrow?
Add an attendee: 
Add jane@company.com to my 3pm meeting tomorrow
List calendars: 
Show me all my calendars
Move an event: 
Move the project review meeting to my Work calendar
View recurring instances: 
Show me all instances of my weekly team standup for this month
Manage calendar access: 
Share my calendar with the marketing team as readers

​
Troubleshooting

IssueSolution
Agent not finding the right dataSpecify dates and times clearly with timezone
Action not completingCheck that you’ve authenticated with Google Calendar
Unexpected resultsThe agent may chain multiple tools (e.g., checking availability first, then creating). Review the agent’s reasoning to understand its approach.
Tool not availableVerify the tool is enabled in your agent’s MCP configuration
Agents are smart enough to chain multiple API calls together. For example, asking “Schedule a meeting when I’m free” will check availability first, then create the event. If results seem off, check the agent’s step-by-step reasoning.

​
Need Help?

Use this integration directly in Claude or Cursor. Connect remotely via the Google Calendar MCP server using your Gumloop credentials.