free_busy
Get merged busy intervals and free gaps for a time window from calendars; returns start/end times only, no event details.
Instructions
Availability in a window: merged busy intervals + free gaps. start/end are
ISO-8601 datetimes (naive local, e.g. 2026-07-20T09:00:00); calendars optional
Pointer ids (from calendars) to restrict to, else all. Returns {"busy": [...],
"free": [...]} of {start, end} — no event details. Read-only; needs EventKit.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"start": "<start>",
"end": "<end>"
},
"name": "free_busy"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | Yes | ||
| start | Yes | ||
| calendars | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||