conecto. Get started
Calendar

List meeting types

calendar_list_meeting_types · Reads only · Markdown

Every meeting type people can book, the business's and each person's own, with its hosts and booking page.

Free*

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

An example

Which appointments can customers book with us, and what are the links?

Your agent callscalendar_list_meeting_typesFree*

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
{}
What comes back
{
  "meeting_types": [
    {
      "slug": "bike-fitting",
      "meeting_type": "bike-fitting",
      "person": null,
      "title": "Bike fitting",
      "description": "",
      "length_minutes": 45,
      "location": {
        "kind": "in_person",
        "value": "Halverson Cycle & Repair, 1830 SE Ash St, Portland, OR 97214"
      },
      "buffer_before": 0,
      "buffer_after": 15,
      "notice_minutes": 120,
      "days_ahead": 60,
      "slot_interval": 45,
      "max_per_day": null,
      "hours": [
        {
          "day": "saturday",
          "start": "10:00",
          "end": "16:00"
        }
      ],
      "questions": [
        {
          "key": "your_height_in_inches",
          "label": "Your height in inches",
          "type": "number",
          "required": false,
          "options": []
        }
      ],
      "ask_phone": "optional",
      "offer_confirmation_call": true,
      "phone_assistant_books_this": false,
      "active": true,
      "booking_url": "https://cncto.co/book/halverson-cycle/bike-fitting"
    }
  ],
  "count": 1
}

Use it when

To find a meeting type's slug or booking page, or who takes its bookings.

What it does

The meeting types people can book, with their booking pages: the business's, then each person's own (meeting_type is how the other tools name each one). person lists only theirs.

What comes back

Every meeting type, the business's first and then each person's, with its settings, hosts and booking URL, and how many there are. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
personstringSomeone on the account, by email: their own calendar instead of the business's. Up to 254 characters.

The call

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

Terminal
curl -X POST https://api.conecto.chat/v1/tools/calendar_list_meeting_types \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

When it refuses

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

CodeWhenWhat to do
not_set_up404The business has no calendar yet.Create it with calendar_setup, then call again.

More Calendar tools

All 13 tools

Give this to your agent.

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