Check Free/Busy Status
calendar_freebusy_queryCheck availability for one or more calendars within a time range to find open meeting slots. Returns busy periods only, preserving privacy.
Instructions
Check availability (free/busy times) for one or more calendars within a time range.
This is useful for finding available meeting times across multiple people. It only returns busy time blocks (not event details) for privacy.
Args:
time_min (string): Start of the time range (ISO 8601 format, e.g., '2024-01-15T00:00:00Z')
time_max (string): End of the time range (ISO 8601 format, e.g., '2024-01-22T00:00:00Z')
calendar_ids (string[]): Array of calendar IDs or email addresses to check (e.g., ['primary', 'colleague@company.com'])
response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns: For each calendar, a list of busy time blocks within the range.
Requirements for checking other people's calendars:
Same Google Workspace organization, OR
They have shared their calendar with you, OR
Their calendar is public
Examples:
Check your availability: calendar_ids=["primary"], time_min="2024-01-15T09:00:00Z", time_max="2024-01-15T18:00:00Z"
Check team availability: calendar_ids=["alice@company.com", "bob@company.com"]
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| time_max | Yes | End of the time range (ISO 8601 format, e.g., '2024-01-22T00:00:00Z') | |
| time_min | Yes | Start of the time range (ISO 8601 format, e.g., '2024-01-15T00:00:00Z') | |
| calendar_ids | Yes | Array of calendar IDs or email addresses to check (e.g., ['primary', 'colleague@company.com']) | |
| response_format | No | Output format: 'markdown' or 'json' | markdown |