Find meeting times
calendar_find_meeting_timesSuggests slots of duration_minutes inside the window when you (across every calendar) and the attendees are free. Slots can fall at night or at weekends unless you pass working_hours_only: true, which most meeting requests want. Only accounts with the calendar.attendee_free_busy capability (see accounts_list) can see other people's time; an attendee none of them can see is left out of the slots and named in warnings with ATTENDEE_NOT_VISIBLE, so tell the user the slot is unconfirmed for that person. Use it before calendar_create_event when the user says "find a time". Times are ISO 8601: with an offset (2026-11-02T09:00:00+02:00), or without one to mean time_zone; all-day events use dates, and their end is the day after the last day. Example: { "duration_minutes": 30, "start": "2026-11-03", "end": "2026-11-06", "attendees": ["ana@contoso.example.com"], "working_hours_only": true }.
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_minutes": "<duration_minutes>",
"start": "<start>",
"end": "<end>"
},
"name": "calendar_find_meeting_times"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | Yes | Window end (exclusive): ISO 8601 date-time or date. | |
| limit | No | How many slots, 1–20 (default 5). | |
| start | Yes | Window start: ISO 8601 date-time or date. | |
| attendees | No | Other people's email addresses who must be free (up to 20). Anyone your accounts cannot see is ignored and named in `warnings`. | |
| time_zone | No | IANA time zone for dates in and out, e.g. "Africa/Johannesburg". Defaults to the workspace time zone, which prubex_overview returns as `time_zone`. | |
| profile_id | No | Only accounts in this profile (`prf_…` from profiles_list). | |
| account_ids | No | Only these accounts (`acc_…`). Omit to cover every account you can reach. | |
| duration_minutes | Yes | How long the meeting is. | |
| working_hours_only | No | Only within your mailbox's working hours (else Monday to Friday 08:00–18:00 in `time_zone`). Default false: slots can fall at night or at weekends. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| slots | Yes | ||
| warnings | No | Accounts that failed or timed out, and attendees no account could see (ATTENDEE_NOT_VISIBLE); everything else is still here. |