Skip to main content
The google-calendar MCP adapter wraps the Google Calendar API. Use it in workflow mcp_call steps to read upcoming events, find free time across calendars, create meetings with Google Meet links, and update or cancel bookings after human approval. Events can be created from structured fields or natural-language quick-add text.

​
Prerequisites

  • A Google account with Calendar access (personal Gmail or Google Workspace)
  • A Google Workspace connection in AgentRuntime (OAuth via the Google account card on Connections)
  • project_contributor access in your workspace

​
Connect in AgentRuntime

1

Connect Google

On Connections, use the Google account card and complete OAuth. See Google Workspace setup and Connections.
2

Enable Calendar

On your Google connection, enable the Calendar service so the account exposes Calendar API scopes.
3

Add google-calendar MCP instance

Go to MCP, click Add instance for google-calendar. Open Instance config, wire your Google connection, and set the profile active.
4

Test in a workflow

Smoke-test with mcp_call in Workflow Studio. Test with get_events on calendar_id: primary before production workflows.

​
What you can build

  • Meeting scheduler — Inbound booking request → find_busy_free_periods across team calendars → LLM picks a slot → create_event with Meet link and attendees.
  • Daily standup digest — Schedule trigger → get_events for today on primary → LLM summary → gmail send to the team channel alias.
  • Post-approval booking — human_task approves time and attendees → create_event with send_notifications: all → google-sheets log confirmation row.
  • Conflict resolver — Webhook with proposed time → find_busy_free_periods → if busy, create_quick_event alternative via LLM-suggested text → notify requester.

​
Tools

ToolDescription
get_eventsList Google Calendar events with optional search, date range, and event-type filters.
get_event_by_idGet a single Google Calendar event by event ID.
find_busy_free_periodsFind busy and free periods across one or more Google Calendars in a time range.
create_eventCreate a Google Calendar event, with optional attendees, location, color, and Meet link.
create_quick_eventCreate a Google Calendar event from natural-language text using quickAdd.
update_eventUpdate an existing Google Calendar event.
delete_eventDelete a Google Calendar event.
add_attendees_to_eventAdd attendees to an existing Google Calendar event.
add_calendar_to_listAdd an existing calendar to the authenticated user’s calendar list.

​
Example

Create a client meeting after a human approves the time slot: 
{
  "id": "book-meeting",
  "type": "mcp_call",
  "name": "Create calendar event",
  "tool_name": "create_event",
  "tool_args": {
    "calendar_id": "primary",
    "title": "{{steps.human-approve.result.meeting_title}}",
    "start_date_time": "{{steps.human-approve.result.start_time}}",
    "end_date_time": "{{steps.human-approve.result.end_time}}",
    "attendees": ["{{input.client_email}}", "{{input.owner_email}}"],
    "create_meet_link": true,
    "send_notifications": "all"
  },
  "depends_on": ["human-approve"],
  "timeout_s": 45
}

​
Troubleshooting

IssueFix
Reconnect prompt on Google connectionRe-authorize OAuth; Calendar scopes may have been revoked
403 or calendar not foundConfirm calendar_id — use primary for the signed-in user’s main calendar
Attendees not receiving invitesSet send_notifications to all on create or update
find_busy_free_periods shows unexpected busy blocksInclude all relevant calendar_ids; check shared calendars the account can read