# Query Google Calendar free/busy

Canonical URL: https://docs.fuse.init.inc/integrations/google-workspace/actions/calendar.freebusy.query

Query free/busy information for calendars the connected principal can access.

Action ID: `calendar.freebusy.query`
Provider: Google Workspace (`google_workspace`)
Contract version: 1

## Risk and exposure

- Risk: Read
- Idempotency: Safe — Safe to retry without coordination; repeats do not create additional side effects.
- Availability: Default
- Exposure: REST, SDK, MCP
- MCP hints: readOnly=true, destructive=false, idempotent=true, openWorld=true

## Required scopes

- `https://www.googleapis.com/auth/calendar.freebusy`

## Input schema fields

- `time_min`
- `time_max`
- `items`
- `items[]`
- `items[].id`

## Output schema fields

- `calendars`
- `calendars[]`
- `calendars[].id`
- `calendars[].busy`
- `calendars[].busy[]`
- `calendars[].busy[].start`
- `calendars[].busy[].end`

Provider overview: https://docs.fuse.init.inc/integrations/google-workspace
Actions index: https://docs.fuse.init.inc/integrations/google-workspace/actions
Exact canonical JSON contract: https://docs.fuse.init.inc/api/catalog/v1/providers/google_workspace/actions/calendar.freebusy.query
Deployment-effective discovery: https://api.fuse.init.inc/v1/tenants/%7Btenant_id%7D/providers/google_workspace/actions