Boulevard API and MCP server Let your AI agent run the Boulevard front desk.

ToolWhat it doesAccess

• list_locations Your business locations with name and address. read

  Returns every location the signed-in user can access. Use the location_id from each item in the other tools. Boulevard bills and configures each location separately, so a multi-location business gets several items.

  MCP callboulevard_read → list_locations

  REST endpointGET https://cotlet.dev/api/v1/boulevard/locations

  Parameters

  No parameters.

  Example response

  {
    "locations": [
      {
        "location_id": "loc_1",
        "name": "Downtown",
        "address": "412 Alder St, Portland, OR"
      }
    ]
  }

• list_appointments Appointments on the calendar for a day or week with client, services, provider and status. read

  Returns the appointments in a date range in start order, each with client, services, provider, start, end and state. Filter by provider to read one calendar. Canceled appointments are not on the calendar, so read them with list_cancelled_appointments.

  MCP callboulevard_read → list_appointments

  REST endpointGET https://cotlet.dev/api/v1/boulevard/appointments

  Parameters

  Parameters: list_appointments

  Name	Type	Description
  location_id string	string	Location ID from list_locations. Default: your first location.
  from date required	date	First day, inclusive.
  to date	date	Last day, inclusive. Default: same as from.
  staff_id string	string	Only this provider.

  Example input

  {
    "from": "2026-10-01"
  }

  Example response

  {
    "appointments": [
      {
        "appointment_id": "ap_903114",
        "client": {
          "client_id": "cl_48213",
          "name": "Jamie Doe"
        },
        "services": [
          {
            "name": "Signature Facial"
          }
        ],
        "provider": {
          "staff_id": "st_207",
          "name": "Alex"
        },
        "start": "2026-11-02T14:00:00-08:00",
        "end": "2026-11-02T15:00:00-08:00",
        "state": "confirmed"
      }
    ]
  }

• get_appointment One appointment with its services, notes and the Appointment Updates history. read

  Returns the appointment details as the preview window shows them: client, services with their times, provider, the appointment note and the Appointment Updates list, which records who rescheduled it and when. Use it before moving or canceling an appointment.

  MCP callboulevard_read → get_appointment

  REST endpointGET https://cotlet.dev/api/v1/boulevard/appointments/{appointment_id}

  Parameters

  Parameters: get_appointment

  Name	Type	Description
  appointment_id string required	string	Appointment ID from list_appointments.

  Example input

  {
    "appointment_id": "appointment_8c41d2"
  }

  Example response

  {
    "appointment_id": "ap_903114",
    "client": {
      "client_id": "cl_48213",
      "name": "Jamie Doe"
    },
    "services": [
      {
        "name": "Signature Facial",
        "start": "2026-11-02T14:00:00-08:00",
        "end": "2026-11-02T15:00:00-08:00"
      }
    ],
    "provider": {
      "staff_id": "st_207",
      "name": "Alex"
    },
    "state": "confirmed",
    "note": null,
    "updates": [
      {
        "action": "booked",
        "by": "Front desk",
        "at": "2026-10-29T09:12:00-07:00"
      }
    ]
  }

• list_cancelled_appointments The Recent Cancellations list: canceled appointments with client, service and reason. read

  Returns the Cancelled Appointments List, newest first, with client, services, provider, the time that opened up and the cancellation reason. Boulevard has no separate cancellation report, so this list is the source. Restore one with restore_cancelled_appointment.

  MCP callboulevard_read → list_cancelled_appointments

  REST endpointGET https://cotlet.dev/api/v1/boulevard/cancelled-appointments

  Parameters

  Parameters: list_cancelled_appointments

  Name	Type	Description
  location_id string	string	Location ID from list_locations. Default: your first location.

  Example response

  {
    "cancellations": [
      {
        "appointment_id": "ap_903210",
        "client": {
          "client_id": "cl_50122",
          "name": "Dana Ruiz"
        },
        "services": [
          {
            "name": "Brow Shaping"
          }
        ],
        "provider": {
          "staff_id": "st_207",
          "name": "Alex"
        },
        "start": "2026-11-03T15:00:00-08:00",
        "reason": "client_late_canceled"
      }
    ]
  }

ToolWhat it doesAccess

• book_appointment Book one or more services for a client with a provider. writeasks first

  Adds an appointment to the calendar the way New Appointment does. The time must be free for the provider and the appointment takes it off online booking. No card is needed on file. Returns the appointment with start and end. By default you confirm each call; you can switch that off for this tool.

  MCP callboulevard_write → book_appointment

  REST endpointPOST https://cotlet.dev/api/v1/boulevard/clients/{client_id}/appointments

  Parameters

  Parameters: book_appointment

  Name	Type	Description
  client_id string required	string	Client ID from find_client.
  location_id string	string	Location ID from list_locations. Default: your first location.
  services string[] required	string[]	Service names exactly as the menu shows them.
  staff_id string required	string	Provider performing the services.
  start datetime required	datetime	ISO 8601 with time zone.
  note string	string	Appointment note.

  Example input

  {
    "client_id": "cl_48213",
    "location_id": "loc_1",
    "services": [
      "Signature Facial"
    ],
    "staff_id": "st_207",
    "start": "2026-11-06T14:00:00-08:00"
  }

  Example response

  {
    "appointment_id": "ap_903114",
    "status": "booked",
    "client": {
      "client_id": "cl_48213",
      "name": "Jamie Doe"
    },
    "services": [
      {
        "name": "Signature Facial"
      }
    ],
    "provider": {
      "staff_id": "st_207",
      "name": "Alex"
    },
    "start": "2026-11-06T14:00:00-08:00",
    "end": "2026-11-06T15:00:00-08:00"
  }

• reschedule_appointment Move an appointment to a new time, day or provider. writeasks first

  Moves one appointment, as dragging it on the calendar does. Boulevard asks whether to notify the client, so notify_client decides whether the client hears about the move. Every service of a multi-service appointment must stay on the same day. The change is logged in Appointment Updates. By default you confirm each call; you can switch that off for this tool.

  MCP callboulevard_write → reschedule_appointment

  REST endpointPOST https://cotlet.dev/api/v1/boulevard/appointments/{appointment_id}/reschedule

  Parameters

  Parameters: reschedule_appointment

  Name	Type	Description
  appointment_id string required	string	Appointment ID from list_appointments.
  start datetime required	datetime	New start, ISO 8601 with time zone.
  staff_id string	string	New provider. Default: unchanged.
  notify_client boolean	boolean	Notify the client about the change. Default: false.

  Example input

  {
    "appointment_id": "appointment_8c41d2",
    "start": "2026-10-01T09:00:00Z"
  }

  Example response

  {
    "appointment_id": "ap_903114",
    "status": "rescheduled",
    "provider": {
      "staff_id": "st_207",
      "name": "Alex"
    },
    "start": "2026-11-03T11:00:00-08:00",
    "end": "2026-11-03T12:00:00-08:00",
    "client_notified": true
  }

• cancel_appointment Cancel an appointment with one of the five Boulevard reasons. writeasks first

  Cancels one appointment with a reason: mistake_or_error, staff_canceled, client_canceled, client_late_canceled or client_no_show. notify_client sends or skips the cancellation email. The tool charges no cancellation fee; charging one stays in the dashboard. The appointment goes to the Cancelled Appointments List. By default you confirm each call; you can switch that off for this tool.

  MCP callboulevard_write → cancel_appointment

  REST endpointPOST https://cotlet.dev/api/v1/boulevard/appointments/{appointment_id}/cancel

  Parameters

  Parameters: cancel_appointment

  Name	Type	Description
  appointment_id string required	string	Appointment ID from list_appointments.
  reason enum required	enum	mistake_or_error, staff_canceled, client_canceled, client_late_canceled or client_no_show.
  notify_client boolean	boolean	Send the cancellation email to the client. Default: true.

  Example input

  {
    "appointment_id": "appointment_8c41d2",
    "reason": "mistake_or_error"
  }

  Example response

  {
    "appointment_id": "ap_903210",
    "status": "canceled",
    "reason": "client_late_canceled",
    "client_notified": true
  }

• restore_cancelled_appointment Undo a cancellation from the Cancelled Appointments List. writeasks first

  Restores a canceled appointment to the calendar, as Restore does in the Cancelled Appointments List. The slot must still be free. Use it when an appointment was canceled by mistake. By default you confirm each call; you can switch that off for this tool.

  MCP callboulevard_write → restore_cancelled_appointment

  REST endpointPOST https://cotlet.dev/api/v1/boulevard/appointments/{appointment_id}/cancelled-appointment/restore

  Parameters

  Parameters: restore_cancelled_appointment

  Name	Type	Description
  appointment_id string required	string	Appointment ID from list_appointments.

  Example input

  {
    "appointment_id": "appointment_8c41d2"
  }

  Example response

  {
    "appointment_id": "ap_903210",
    "status": "restored",
    "start": "2026-11-03T15:00:00-08:00"
  }

ToolWhat it doesAccess

• list_waitlist Waitlist entries with client, phone, requested provider, services and preferred time. read

  Returns the entries of the location waitlist as the Waitlist screen shows them: client name, phone, requested provider, services, preferred time and note. Entries made online are first-available requests and ignore closures and the requested provider. A booked entry leaves the list.

  MCP callboulevard_read → list_waitlist

  REST endpointGET https://cotlet.dev/api/v1/boulevard/waitlists

  Parameters

  Parameters: list_waitlist

  Name	Type	Description
  location_id string	string	Location ID from list_locations. Default: your first location.
  date date	date	Only entries for this requested day. Default: all entries.

  Example response

  {
    "entries": [
      {
        "entry_id": "wl_2207",
        "client": {
          "client_id": "cl_51007",
          "name": "Priya Shah"
        },
        "phone": "+15035550188",
        "provider": "Alex",
        "services": [
          "Signature Facial"
        ],
        "preferred": "Tue 3 Nov, afternoon",
        "note": "Added by front desk",
        "source": "staff"
      }
    ]
  }

• book_from_waitlist Book a waitlist entry into an open time. writeasks first

  Books the entry the way Book does on the waitlist: the client gets the appointment and the entry leaves the list. The provider must be free at the start time. By default you confirm each call; you can switch that off for this tool.

  MCP callboulevard_write → book_from_waitlist

  REST endpointPOST https://cotlet.dev/api/v1/boulevard/entries/{entry_id}/waitlists

  Parameters

  Parameters: book_from_waitlist

  Name	Type	Description
  entry_id string required	string	Waitlist entry ID from list_waitlist.
  start datetime required	datetime	ISO 8601 with time zone.
  staff_id string	string	Provider. Default: the one the entry asked for.

  Example input

  {
    "entry_id": "entry_8c41d2",
    "start": "2026-10-01T09:00:00Z"
  }

  Example response

  {
    "entry_id": "wl_2207",
    "status": "booked",
    "appointment_id": "ap_903377",
    "client": {
      "client_id": "cl_51007",
      "name": "Priya Shah"
    },
    "provider": {
      "staff_id": "st_207",
      "name": "Alex"
    },
    "start": "2026-11-03T15:00:00-08:00"
  }

ToolWhat it doesAccess

• find_client Search clients by name, phone or email. read

  Searches the client list and returns every match with contact details. Boulevard warns about duplicates by first and last name, email or phone, so two matches are possible; pass the chosen client_id to the other client tools.

  MCP callboulevard_read → find_client

  REST endpointGET https://cotlet.dev/api/v1/boulevard/clients/find

  Parameters

  Parameters: find_client

  Name	Type	Description
  query string required	string	Name, phone number or email.

  Example input

  {
    "query": "query"
  }

  Example response

  {
    "clients": [
      {
        "client_id": "cl_48213",
        "name": "Jamie Doe",
        "email": "client@example.com",
        "phone": "+15035550142"
      }
    ]
  }

• get_client_profile A client profile: visit metrics, scheduling alert, client notes and allergies. read

  Returns the Overview of one client profile: Appointments, Show Rate, Average Revisit and Average Revisit Value, the Scheduling Alert and the internal client notes and allergies. Notes need the View Client Notes permission; without it the notes are left out and the rest still returns.

  MCP callboulevard_read → get_client_profile

  REST endpointGET https://cotlet.dev/api/v1/boulevard/clients/{client_id}/profile

  Parameters

  Parameters: get_client_profile

  Name	Type	Description
  client_id string required	string	Client ID from find_client.

  Example input

  {
    "client_id": "client_8c41d2"
  }

  Example response

  {
    "client_id": "cl_48213",
    "name": "Jamie Doe",
    "metrics": {
      "appointments": 14,
      "show_rate": "93%",
      "average_revisit_days": 38,
      "average_revisit_value": 142
    },
    "scheduling_alert": "Prefers fragrance-free products",
    "notes": [
      {
        "tab": "note",
        "text": "Color formula 6N with 20 volume, 35 minutes",
        "added": "2026-09-14"
      }
    ],
    "allergies": [
      {
        "text": "Lavender oil",
        "added": "2026-06-02"
      }
    ]
  }

• add_client_note Add a private note or an allergy to a client profile. write

  Adds text to the Client Notes of a profile, on the NOTE tab or the ALLERGIES tab. Notes are internal and only staff with access to client profiles see them. Needs the Create and Modify Client Notes permission. A note reaches no one and you can delete it in the profile, so add_client_note runs without asking first.

  MCP callboulevard_write → add_client_note

  REST endpointPOST https://cotlet.dev/api/v1/boulevard/clients/{client_id}/note

  Parameters

  Parameters: add_client_note

  Name	Type	Description
  client_id string required	string	Client ID from find_client.
  text string required	string	Note text. Internal, never shown to the client.
  tab enum	enum	note or allergies. Default: note.

  Example input

  {
    "client_id": "client_8c41d2",
    "text": "text"
  }

  Example response

  {
    "client_id": "cl_51007",
    "tab": "note",
    "status": "added",
    "text": "Formula 6N with 20 volume, 35 minutes. Wants it a shade warmer next time."
  }

• set_scheduling_alert Set the one Scheduling Alert on a client profile. write

  Writes the private Scheduling Alert that shows as a red banner when staff create an appointment for the client and in the appointment preview. A profile holds one alert, so this replaces the old text; read it first with get_client_profile. It reaches no one and you can edit it again at any time, so set_scheduling_alert runs without asking first.

  MCP callboulevard_write → set_scheduling_alert

  REST endpointPUT https://cotlet.dev/api/v1/boulevard/clients/{client_id}/scheduling-alert

  Parameters

  Parameters: set_scheduling_alert

  Name	Type	Description
  client_id string required	string	Client ID from find_client.
  text string required	string	Alert text. Replaces the current alert.

  Example input

  {
    "client_id": "client_8c41d2",
    "text": "text"
  }

  Example response

  {
    "client_id": "cl_48213",
    "status": "saved",
    "scheduling_alert": "Deposit card expired, ask for a new one at booking"
  }

ToolWhat it doesAccess

• get_report One of the dashboard reports for a date range, as rows. read

  Returns a report from the reporting section as rows. daily_summary rolls up sales, refunds and discounts by day; appointments lists each appointment with its state and forecasted and final net sale; client_waitlist lists every waitlist entry, removed ones included. Needs the matching Data & Reporting permission and the new reporting experience on the account.

  MCP callboulevard_read → get_report

  REST endpointGET https://cotlet.dev/api/v1/boulevard/report

  Parameters

  Parameters: get_report

  Name	Type	Description
  report enum required	enum	daily_summary, appointments or client_waitlist.
  from date required	date	First day, inclusive.
  to date required	date	Last day, inclusive.
  location_ids string[]	string[]	Locations to include. Default: all you can access.

  Example input

  {
    "report": "daily_summary",
    "from": "2026-10-01",
    "to": "2026-10-01"
  }

  Example response

  {
    "report": "daily_summary",
    "from": "2026-10-26",
    "to": "2026-10-28",
    "currency": "USD",
    "rows": [
      {
        "date": "2026-10-26",
        "net_sales": 3120,
        "refunds": 45
      },
      {
        "date": "2026-10-27",
        "net_sales": 3480,
        "refunds": 0
      },
      {
        "date": "2026-10-28",
        "net_sales": 2960,
        "refunds": 90
      }
    ]
  }