conecto. Get started
Calendar

List bookings

calendar_list_bookings · Reads only · Markdown

Bookings between two times (from now on by default), soonest first, with each one's hosts, guests and confirmation call.

Free*

*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.

An example

Who is coming in for a fitting this week?

Your agent callscalendar_list_bookingsFree*

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.

With these arguments
{
  "from": "2026-10-19T00:00:00-07:00",
  "to": "2026-10-24T23:59:00-07:00"
}
What comes back
{
  "bookings": [
    {
      "booking_id": "ec535d25-fba9-435c-9f24-e9099c967ab3",
      "reference": "KP8GGN56KJ",
      "status": "scheduled",
      "meeting_type": "bike-fitting",
      "title": "Bike fitting",
      "start": "2026-10-24T18:30:00+00:00",
      "end": "2026-10-24T19:15:00+00:00",
      "attendee_local_time": "Saturday, October 24, 2026 at 11:30 (America/Los Angeles)",
      "attendee": {
        "name": "Rachel Kim",
        "email": "rachel.kim@example.com",
        "phone": null,
        "timezone": "America/Los_Angeles"
      },
      "hosts": [],
      "guests": [],
      "answers": {},
      "location": "Halverson Cycle & Repair, 1830 SE Ash St, Portland, OR 97214",
      "booked_via": "bot",
      "manage_url": "https://cncto.co/booking/ec535d25-fba9-435c-9f24-e9099c967ab3?t=ImVjNTM1ZDI1LWZiYTktNDM1Yy05ZjI0LWU5MDk5Yzk2N2FiMyI:1xJYro:NJLXW-h5yu5BRPp5j7vMCKzVNJzX35k_CUqFS8vilLo",
      "confirmation_call": null,
      "cancel_reason": null
    }
  ],
  "count": 1
}

Use it when

Someone asks who is coming, or a booking's reference is needed to move or cancel it.

What it does

Bookings between two times (default: from now on), soonest first, with each one's hosts, guests and confirmation call. person lists the meetings that person has.

What comes back

Up to 200 bookings, soonest first, each with its reference, times, attendee, hosts, guests, answers, location, manage link and confirmation call, and how many were listed. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
fromstring (date-time)
tostring (date-time)
statusstringOne of: scheduled,cancelled,any. Default: scheduled.
meeting_typestring
personstringSomeone on the account, by email: their own calendar instead of the business's. Up to 254 characters.
limitinteger1 to 200. Default: 50.

The call

Over MCP, call calendar_list_bookings on https://api.conecto.chat/mcp/calendar. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/calendar_list_bookings \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"from":"2026-10-19T00:00:00-07:00","to":"2026-10-24T23:59:00-07:00"}'

When it refuses

A refused call costs nothing and says what to do next.

CodeWhenWhat to do
invalid_input400A time is not ISO 8601 with its offset, or a time zone is unknown.Send times like 2026-10-24T11:00:00-07:00 and zones like America/Los_Angeles.

More Calendar tools

All 13 tools

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md