Find free times
Free start times for a meeting type between two dates, in the time zone you ask for.
Free*
*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.
An example
Which bike fitting slots are still free next week?
Your agent callscalendar_find_timesFree*
The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.
{
"meeting_type": "bike-fitting",
"from": "2026-10-19",
"to": "2026-10-24",
"timezone": "America/Los_Angeles"
}Use it when
Before booking: to offer someone times, or to check a time is free.
What it does
Free start times for a meeting type between two dates (up to 62 days), shown in the time zone you ask for. For a round-robin type, host shows only that host's free times. Book one with calendar_book.
What comes back
Free start times grouped by day in the requested time zone, the meeting length, and how many there are. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
meeting_typeRequired | string | Its slug, or "<person's address>/<slug>" for a person's own type. |
person | string | The meeting type is on this person's own calendar. Up to 254 characters. |
host | string | A round-robin type: only this host. Up to 254 characters. |
from | string (date) | |
to | string (date) | |
timezone | string | Show times in this IANA zone (default: the calendar's). Up to 80 characters. |
The call
Over MCP, call calendar_find_times on https://api.conecto.chat/mcp/calendar. Over REST:
curl -X POST https://api.conecto.chat/v1/tools/calendar_find_times \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"meeting_type":"bike-fitting","from":"2026-10-19","to":"2026-10-24","timezone":"America/Los_Angeles"}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
not_set_up404 | The business has no calendar yet. | Create it with calendar_setup, then call again. |
not_found404 | No meeting type has that slug. | Call calendar_list_meeting_types and use one of its slugs. |
invalid_input400 | from or to is not a date, the range is too long, or the time zone is unknown. | Send dates like 2026-10-19, at most 62 days apart, and a zone like America/Los_Angeles. |
not_a_host400 | host is not one of the meeting type's round-robin hosts. | Leave host out, or name one of the hosts calendar_list_meeting_types shows. |
More Calendar tools
All 13 tools- Set up the calendar
calendar_setupSets the business's calendar or a person's own: name, booking address, time zone, weekly hours, closed days, reminder emails and confirmation calls.$0.001 a call - Get the calendar setup
calendar_get_setupThe calendar's settings, booking page, iCal link, connected Google calendar, meeting types, and its people's own calendars.Free* - Connect Google Calendar
calendar_connectA link that opens a page naming the business, where the owner, or a person for their own page, connects Google Calendar in one click.Free* - Save a meeting type
calendar_save_meeting_typeCreates or changes a kind of meeting people can book, on the business's calendar or a person's, taken by one host, a round robin or everyone.$0.001 a call - List meeting types
calendar_list_meeting_typesEvery meeting type people can book, the business's and each person's own, with its hosts and booking page.Free* - Book a meeting
calendar_bookBooks a free time for someone, who gets a confirmation email with an invite and a link to change it.$0.01 a call - List bookings
calendar_list_bookingsBookings between two times (from now on by default), soonest first, with each one's hosts, guests and confirmation call.Free* - Move a meeting
calendar_moveMoves a booking to another free time and sends the attendee an updated invite.$0.01 a call
Give this to your agent.
Set up Conecto from https://conecto.chat/SKILL.md