Google Calendar Skill

Overview

This skill guides you in using the google_calendar MCP tool to manage calendar events across all connected Google accounts.

Available Subcommands

Subcommand	Description
list	List upcoming events (defaults to next 7 days).
get <eventId>	Get details of a specific event.
create	Create a new calendar event.
update <eventId>	Update an existing event.
delete <eventId>	Delete an event.
rsvp <eventId>	Accept, decline, or tentatively accept an event.
free-time	Find available meeting slots across all connected calendars.

Account Routing

• Reads (list, get, free-time): Omit account to query all accounts simultaneously.
• Writes (create, update, delete, rsvp): You must specify account. Ask the user if unclear.

google_calendar(command: "list")                                     // all accounts
google_calendar(command: "free-time --duration 60")                 // all accounts
google_calendar(command: "create --title 'Team Sync'", account: "Work")

Key Flags

Flag	Description
--start <datetime>	Start time in ISO 8601 format
--end <datetime>	End time in ISO 8601 format
--days <n>	Number of days to look ahead (list only, default: 7)
--title <text>	Event title
--description <text>	Event description
--location <text>	Event location
--attendees <emails>	Comma-separated attendee emails
--duration <minutes>	Required slot duration in minutes (free-time only)
--response <r>	RSVP response: accepted / declined / tentative

Workflow: Scheduling a Meeting

1. Find free time: google_calendar(command: "free-time --duration 60 --days 5")
2. Confirm a slot with the user.
3. Create the event: google_calendar(command: "create --title 'Meeting' --start '2026-04-15T14:00:00' --end '2026-04-15T15:00:00' --attendees 'alice@example.com'", account: "Work")

Free-Time Algorithm

free-time fetches events from all connected accounts, merges overlapping busy intervals, and returns up to 10 available slots of at least the requested duration within the search window.

Error Handling

• If no accounts are connected, direct user to Settings → Integrations.
• If account is required but not specified, ask the user which account to use before proceeding.