Find Meeting Times
find_meeting_availabilityFind meeting time suggestions where all participants are free, ranked by confidence, within a specified window and duration. Suggests slots only; use create_event to book.
Instructions
Find meeting time suggestions where all participants are free, ranked by confidence. Searches between after_date_time and before_date_time for a slot of duration_minutes. Read-only: suggests times only — use create_event to book one.
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": {
"participants": "<participants>",
"after_date_time": "<after_date_time>",
"before_date_time": "<before_date_time>"
},
"name": "find_meeting_availability"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| participants | Yes | Attendee email addresses. The signed-in user is automatically the organizer. | |
| max_candidates | No | Max slots to return (default: 3) | |
| after_date_time | Yes | Search window start (ISO 8601, e.g. 2026-06-04T00:00:00Z) | |
| before_date_time | Yes | Search window end (ISO 8601, e.g. 2026-06-06T00:00:00Z) | |
| duration_minutes | No | Meeting length in minutes (default: 30) | |
| is_organizer_optional | No | Whether the organizer's attendance is optional (default: false) |