Find meeting times
find_timesFind three chronologically labeled slots; nothing is held. Quote each rationale verbatim; starts_at/ends_at are opaque: never reformat or do timezone math. co_host_emails: members only, never invitees; relay dropped_co_hosts. Card-moved slots are confirmed. Confirmed times are final: never call find_times again to validate, swap, commit or re-render them; search again only if the user asks for different times or a real conflict is returned. Once times are chosen, confirm topic and agenda once, then call propose_meeting. propose_meeting rechecks availability before placing holds. Modes: FRESH searches (per-day counts: ONE call with windows; each call draws a card); SWAP (current_slots + propose_label) re-picks one slot and awaits a yes; COMMIT (current_slots only) finalizes labels. With a card, reply briefly; otherwise list rationale bullets. Overrides, shortfalls and signed_in_as: capable://guide/scheduling.
When to use: Find candidate meeting times.
Example: Find three 30-minute morning slots next week.
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": {
"duration_min": "<duration_min>",
"window_start": "<window_start>",
"window_end": "<window_end>"
},
"name": "find_times"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| windows | No | FRESH only: parts inside the window with counts adding up to 3, e.g. Monday 1, Thursday 2. | |
| window_end | Yes | ISO 8601 end of the search window. | |
| duration_min | Yes | Meeting duration in minutes (30, 45, 60, or 90). | |
| window_start | Yes | ISO 8601 start of the search window. | |
| current_slots | No | The 3 slots with labels exactly as returned, never reformatted. With propose_label swaps one; alone commits an accepted swap. | |
| propose_label | No | Slot to re-pick (needs current_slots); narrow the window to the user's hint ("Friday morning" → that day 9–12). Not for committing. | |
| co_host_emails | No | Workspace members who also attend; every host's calendar is intersected. Never the external invitee: pass invitee_timezone instead. | |
| invitee_timezone | No | Invitee IANA timezone (e.g. "Europe/Berlin"); candidates then also fit 9–17 Mon–Fri there. Translate a named city, country or offset; never infer it from an email domain. | |
| target_starts_at | No | Exact ISO start for the swap (needs current_slots and propose_label). On failure proposed_slot.new is null with target_failure_reason; never substituted. | |
| workday_end_hour | No | Latest hour in each host's timezone; omit for saved hours. Only to narrow this search ("mornings only" → 12). | |
| workday_start_hour | No | Earliest hour in each host's timezone; omit for saved hours. Only to narrow this search ("after 2pm" → 14). Never saved. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | ||
| note | No | ||
| hosts | No | ||
| slots | No | ||
| events | No | ||
| shortfall | No | ||
| timed_out | No | ||
| duration_min | No | ||
| signed_in_as | No | ||
| host_timezone | No | ||
| proposed_slot | No | ||
| co_host_notice | No | ||
| dropped_co_hosts | No | ||
| invitee_timezone | No | ||
| workday_end_hour | No | ||
| workday_start_hour | No | ||
| visualization_weeks | No | ||
| cohost_busy_intervals | No | ||
| availability_blackouts | No | ||
| display_offset_minutes | No | ||
| scheduling_constraints | No | ||
| cohost_blackout_intervals | No | ||
| calendar_context_available | No |