---
name: "calendar_get_setup"
area: "calendar"
title: "Get the calendar setup"
price: "free"
method: "POST"
url: "https://api.conecto.chat/v1/tools/calendar_get_setup"
mcp_server: "https://api.conecto.chat/mcp/calendar"
auth: "Authorization: Bearer <conecto_sk_ key>"
docs_url: "https://conecto.chat/tools/calendar/calendar_get_setup"
---

# Get the calendar setup (`calendar_get_setup`)

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

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.

Price: Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads. A call that fails costs nothing.

## 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.

## Say this to your agent

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

## Inputs

| Name | Type | Required | Description | Allowed values | Default |
|---|---|---|---|---|---|
| `person` | string | no | Someone on the account, by email: their own calendar instead of the business's. Up to 254 characters. |  |  |

## Example

Written for Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon.

MCP: call `calendar_get_setup` on the MCP server `https://api.conecto.chat/mcp/calendar` with these arguments:

```json
{}
```

REST:

```bash
curl https://api.conecto.chat/v1/tools/calendar_get_setup \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## Response

```json
{
  "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93",
  "tool": "calendar_get_setup",
  "status": "succeeded",
  "replayed": false,
  "cost_usd": "$0.00",
  "balance_usd": "$19.75",
  "result": {
    "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": []
    }
  }
}
```

`result`: 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.

## Errors

| Code | Status | When | Fix |
|---|---|---|---|
| `not_set_up` | 404 | The business has no calendar yet. | Create it with calendar_setup, then call again. |

The refusals every tool can give (401 key, 402 balance, 429 limits) are on the errors page: https://conecto.chat/docs/errors.md

## Related

- [calendar_setup](https://conecto.chat/tools/calendar/calendar_setup.md): Sets 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.
- [calendar_connect](https://conecto.chat/tools/calendar/calendar_connect.md): A 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 up to 1,000,000 reads a month.
- [calendar_save_meeting_type](https://conecto.chat/tools/calendar/calendar_save_meeting_type.md): Creates 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.
- [calendar_list_meeting_types](https://conecto.chat/tools/calendar/calendar_list_meeting_types.md): Every meeting type people can book, the business's and each person's own, with its hosts and booking page. Free up to 1,000,000 reads a month.
- [calendar_find_times](https://conecto.chat/tools/calendar/calendar_find_times.md): Free start times for a meeting type between two dates, in the time zone you ask for. Free up to 1,000,000 reads a month.
- [calendar_book](https://conecto.chat/tools/calendar/calendar_book.md): Books a free time for someone, who gets a confirmation email with an invite and a link to change it. $0.01 a call.
- [calendar_list_bookings](https://conecto.chat/tools/calendar/calendar_list_bookings.md): Bookings between two times (from now on by default), soonest first, with each one's hosts, guests and confirmation call. Free up to 1,000,000 reads a month.
- [calendar_move](https://conecto.chat/tools/calendar/calendar_move.md): Moves a booking to another free time and sends the attendee an updated invite. $0.01 a call.
- [calendar_cancel](https://conecto.chat/tools/calendar/calendar_cancel.md): Cancels a booking and tells the attendee by email, unless notify is false. $0.01 a call.
- [calendar_save_routing_form](https://conecto.chat/tools/calendar/calendar_save_routing_form.md): Creates or changes a routing form that asks visitors a few questions and sends each to the right meeting type, host, site or message. $0.001 a call.
- [calendar_list_routing_forms](https://conecto.chat/tools/calendar/calendar_list_routing_forms.md): The routing forms with their addresses, questions, routes and how many people answered each. Free up to 1,000,000 reads a month.
- [calendar_list_routing_responses](https://conecto.chat/tools/calendar/calendar_list_routing_responses.md): What people answered on the routing forms, newest first, where each was sent, and the booking it led to. Free up to 1,000,000 reads a month.