conecto. Get started
Calendar

Get the calendar setup

calendar_get_setup · Reads only · Markdown

The calendar's settings, booking page, iCal link, connected Google calendar, meeting types, and its people's own calendars.

Free*

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

An example

What are our booking hours right now, and is my Google Calendar connected?

Your agent callscalendar_get_setupFree*

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
{
  "calendar": {
    "name": "Halverson Cycle & Repair",
    "about": null,
    "timezone": "America/Los_Angeles",
    "hours": [
      {
        "day": "monday",
        "start": "10:00",
        "end": "19:00"
      },
      {
        "day": "tuesday",
        "start": "10:00",
        "end": "19:00"
      }
    ],
    "date_exceptions": {
      "2026-12-24": []
    },
    "address": "halverson-cycle",
    "booking_page": "https://cncto.co/book/halverson-cycle",
    "former_addresses": [
      "halverson-cycle-repair"
    ],
    "subscribe_ics": "https://api.conecto.chat/v1/calendar/QnxeK0ZbsXUzFrw7N8KnTuUSWNW0fGex.ics",
    "connected_calendar": null,
    "show_people": true,
    "people": [
      {
        "person": "luis@halversoncycle.example",
        "name": "Luis Ortega",
        "address": "luis-ortega",
        "booking_page": "https://cncto.co/book/luis-ortega",
        "timezone": "America/Los_Angeles",
        "connected_calendar": {
          "provider": "google",
          "account": "luis@halversoncycle.example",
          "calendar": "Luis Ortega"
        },
        "on_account": true,
        "meeting_types": 1,
        "hosts": [
          "bike-fitting"
        ]
      }
    ],
    "reminder_emails": {
      "on": true,
      "hours_before": [
        24
      ],
      "how": "An email to each attendee who gave one, with the time, the place and links to reschedule or cancel. $0.002 each; paid accounts only."
    },
    "confirmation_calls": {
      "on": false,
      "hours_before": null,
      "how": "An automated call before each meeting whose attendee gave a phone number and agreed: a short menu in the business's language where 1 keeps the meeting, 2 cancels it and 3 sends a link to pick another time. No AI. Needs a rented phone number, and calls only landlines and mobiles in its country (the US and Canada count as one)."
    },
    "meeting_types": []
  }
}

Use it when

To read the opening hours, the booking page or the iCal link, to see who has a booking page of their own, or to pick a connected calendar.

What it does

The calendar's settings, booking page, iCal subscribe link, connected Google calendar (with the calendars to choose from) and confirmation calls; for the business's calendar also its meeting types and its people's calendars. person reads someone's own calendar.

What comes back

The calendar settings, booking page and iCal link, the connected calendar with the calendars to choose from, the confirmation calls, every meeting type, and each person's own calendar with their booking page and connected calendar. 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_get_setup on https://api.conecto.chat/mcp/calendar. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/calendar_get_setup \
  -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