Square Appointments API and MCP server Let your AI agent keep the salon calendar ready for the next client.

ToolWhat it doesAccess

• schedule_appointment Create and schedule appointments (specific time, all day, or recurring). Account owner or team member with appointments permissions. Square Appointments Free/Plus/Premium, or Square Free/Plus/Premium with advanced bookings capabilities. Entry points: Dashboard Appointments > Calendar, Appointments POS or Square POS in bookings mode, and Messages. Details can include customer information, location, notes and a card on file; client information is saved to the customer directory. Creating the booking sends a client text or email notification. writeAsks first

  Create and schedule appointments (specific time, all day, or recurring). Account owner or team member with appointments permissions. Square Appointments Free/Plus/Premium, or Square Free/Plus/Premium with advanced bookings capabilities. Entry points: Dashboard Appointments > Calendar, Appointments POS or Square POS in bookings mode, and Messages. Details can include customer information, location, notes and a card on file; client information is saved to the customer directory. Creating the booking sends a client text or email notification.

  MCP callsquare_appointments_write → schedule_appointment

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/appointment/schedule

  Parameters

  No parameters.

  Example response

  {
    "scope": "Account owner or team member with appointments permissions. Square Appointments Free/Plus/Premium, or Square Free/Plus/Premium with advanced bookings capabilities. Entry points: Dashboard Appointments > Calendar, Appointments POS or Square POS in bookings mode, and Messages. Details can include customer information, location, notes and a card on file; client information is saved to the customer directory. Creating the booking sends a client text or email notification"
  }

• appointment_booking_rules Set appointment location, intervals, advance limits, daily limit and Fake-it Filter. Desktop Calendar & booking > Save. Includes virtual/phone location; intervals by duration or 10/15/20/30 minutes; advance minimum 1 hour-4 weeks; horizon 7-365 days. Daily limit restricts customers, not staff. Public availability changes require confirmation. writeAsks first

  Set appointment location, intervals, advance limits, daily limit and Fake-it Filter. Desktop Calendar & booking > Save. Includes virtual/phone location; intervals by duration or 10/15/20/30 minutes; advance minimum 1 hour-4 weeks; horizon 7-365 days. Daily limit restricts customers, not staff. Public availability changes require confirmation.

  MCP callsquare_appointments_write → appointment_booking_rules

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/booking-rules/appointment

  Parameters

  No parameters.

  Example response

  {
    "scope": "Desktop Calendar & booking > Save. Includes virtual/phone location; intervals by duration or 10/15/20/30 minutes; advance minimum 1 hour-4 weeks; horizon 7-365 days. Daily limit restricts customers, not staff. Public availability changes require confirmation"
  }

• add_bookable_team_member Create a bookable team member or make an existing team member bookable. Account owner or team member with the appointments permission to manage all team member calendars. Dashboard Staff > Team > Team members > Add to appointments. Free/Plus/Premium. Booking information set on creation: online bookability, bookable services, description, hours of availability, notification preferences. writeAsks first

  Create a bookable team member or make an existing team member bookable. Account owner or team member with the appointments permission to manage all team member calendars. Dashboard Staff > Team > Team members > Add to appointments. Free/Plus/Premium. Booking information set on creation: online bookability, bookable services, description, hours of availability, notification preferences.

  MCP callsquare_appointments_write → add_bookable_team_member

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/bookable-team-members

  Parameters

  No parameters.

  Example response

  {
    "scope": "Account owner or team member with the appointments permission to manage all team member calendars. Dashboard Staff > Team > Team members > Add to appointments. Free/Plus/Premium. Booking information set on creation: online bookability, bookable services, description, hours of availability, notification preferences"
  }

• edit_team_member_appointment_settings Edit a bookable team member's appointments settings and access. Account owner or team member with appointments permissions to manage all calendars. Dashboard Staff & payroll > Team > team member > Appointments > Edit. Changes team-member access. writeAsks first

  Edit a bookable team member's appointments settings and access. Account owner or team member with appointments permissions to manage all calendars. Dashboard Staff & payroll > Team > team member > Appointments > Edit. Changes team-member access.

  MCP callsquare_appointments_write → edit_team_member_appointment_settings

  REST endpointPATCH https://cotlet.dev/api/v1/square-appointments/team-member-appointment-settings

  Parameters

  No parameters.

  Example response

  {
    "scope": "Account owner or team member with appointments permissions to manage all calendars. Dashboard Staff & payroll > Team > team member > Appointments > Edit. Changes team-member access"
  }

• remove_team_member_from_appointments Remove a team member from appointments. Account owner or team member with appointments permissions to manage all calendars. Dashboard Staff & payroll > Team > team member > Appointments > Remove from appointments > Remove. Changes team-member access. writeAsks first

  Remove a team member from appointments. Account owner or team member with appointments permissions to manage all calendars. Dashboard Staff & payroll > Team > team member > Appointments > Remove from appointments > Remove. Changes team-member access.

  MCP callsquare_appointments_write → remove_team_member_from_appointments

  REST endpointDELETE https://cotlet.dev/api/v1/square-appointments/team-member-from-appointments

  Parameters

  No parameters.

  Example response

  {
    "scope": "Account owner or team member with appointments permissions to manage all calendars. Dashboard Staff & payroll > Team > team member > Appointments > Remove from appointments > Remove. Changes team-member access"
  }

• view_staff_calendars View upcoming appointments for selected staff members on the calendar. Account owner or team member with the appointments permission to manage all team member calendars. Dashboard Appointments > Staff dropdown. Appointments Free/Plus/Premium, or Square Free/Plus/Premium with advanced bookings capabilities. read

  View upcoming appointments for selected staff members on the calendar. Account owner or team member with the appointments permission to manage all team member calendars. Dashboard Appointments > Staff dropdown. Appointments Free/Plus/Premium, or Square Free/Plus/Premium with advanced bookings capabilities.

  MCP callsquare_appointments_read → view_staff_calendars

  REST endpointGET https://cotlet.dev/api/v1/square-appointments/staff-calendars/view

  Parameters

  No parameters.

  Example response

  {
    "scope": "Account owner or team member with the appointments permission to manage all team member calendars. Dashboard Appointments > Staff dropdown. Appointments Free/Plus/Premium, or Square Free/Plus/Premium with advanced bookings capabilities"
  }

• update_staff_availability Edit bookable staff availability per week (one-time change or recurring schedule). Account owner or team member with the appointments permission to manage all team member calendars. Dashboard Appointments > Calendar > clock icon > One-time change or recurring schedule. Changes show on dashboard and POS calendars and on the online booking site, so they alter what the public can book. Plan: Appointments Free/Plus/Premium, or Square plans with advanced bookings capabilities. The one-time vs recurring wording comes from the AU variant of the article. writeAsks first

  Edit bookable staff availability per week (one-time change or recurring schedule). Account owner or team member with the appointments permission to manage all team member calendars. Dashboard Appointments > Calendar > clock icon > One-time change or recurring schedule. Changes show on dashboard and POS calendars and on the online booking site, so they alter what the public can book. Plan: Appointments Free/Plus/Premium, or Square plans with advanced bookings capabilities. The one-time vs recurring wording comes from the AU variant of the article.

  MCP callsquare_appointments_write → update_staff_availability

  REST endpointPATCH https://cotlet.dev/api/v1/square-appointments/staff-availability

  Parameters

  No parameters.

  Example response

  {
    "scope": "Account owner or team member with the appointments permission to manage all team member calendars. Dashboard Appointments > Calendar > clock icon > One-time change or recurring schedule. Changes show on dashboard and POS calendars and on the online booking site, so they alter what the public can book. Plan: Appointments Free/Plus/Premium, or Square plans with advanced bookings capabilities. The one-time vs recurring wording comes from the AU variant of the article"
  }

• manage_bookable_resources Create resources and assign eligible resources to services or variations. Desktop Items > Resources > Create resource; name, optional description and one location. Service library > service > Require a resource > select resources > Save. Premium and general items permission. One eligible resource is reserved per booking, not necessarily every selected alternative. writeAsks first

  Create resources and assign eligible resources to services or variations. Desktop Items > Resources > Create resource; name, optional description and one location. Service library > service > Require a resource > select resources > Save. Premium and general items permission. One eligible resource is reserved per booking, not necessarily every selected alternative.

  MCP callsquare_appointments_write → manage_bookable_resources

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/bookable-resources/manage

  Parameters

  No parameters.

  Example response

  {
    "scope": "Desktop Items > Resources > Create resource; name, optional description and one location. Service library > service > Require a resource > select resources > Save. Premium and general items permission. One eligible resource is reserved per booking, not necessarily every selected alternative"
  }

• create_manage_services Create/edit services and variations, enable bookability, and import services. Desktop Items > Service library; general items permission. Documented fields include image, category, taxes, price/type, duration, location, variation staff/bookability, resources, modifiers and custom attributes; optional Generate description. Import CSV or website list, review/edit, Save. Processing time, cost tracking and colors are separately added. writeAsks first

  Create/edit services and variations, enable bookability, and import services. Desktop Items > Service library; general items permission. Documented fields include image, category, taxes, price/type, duration, location, variation staff/bookability, resources, modifiers and custom attributes; optional Generate description. Import CSV or website list, review/edit, Save. Processing time, cost tracking and colors are separately added.

  MCP callsquare_appointments_write → create_manage_services

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/manage-services

  Parameters

  No parameters.

  Example response

  {
    "scope": "Desktop Items > Service library; general items permission. Documented fields include image, category, taxes, price/type, duration, location, variation staff/bookability, resources, modifiers and custom attributes; optional Generate description. Import CSV or website list, review/edit, Save. Processing time, cost tracking and colors are separately added"
  }

• convert_items_to_services Irreversibly convert whole-unit catalog items into services. Desktop Service library > Actions > Convert items to services; select items, durations > Convert > Confirm Conversion. No fractional items; service inventory tracking/dining options unsupported. writeAsks first

  Irreversibly convert whole-unit catalog items into services. Desktop Service library > Actions > Convert items to services; select items, durations > Convert > Confirm Conversion. No fractional items; service inventory tracking/dining options unsupported.

  MCP callsquare_appointments_write → convert_items_to_services

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/items-to-services/convert

  Parameters

  No parameters.

  Example response

  {
    "scope": "Desktop Service library > Actions > Convert items to services; select items, durations > Convert > Confirm Conversion. No fractional items; service inventory tracking/dining options unsupported"
  }

• service_cost_and_buffer_settings Track service cost and configure post-appointment blocked time. Desktop service editor: Track service cost with cost type/amount on Premium; Block extra time after appointment on Plus/Premium. Limit to documented service fields; no undocumented commission-editor controls. writeAsks first

  Track service cost and configure post-appointment blocked time. Desktop service editor: Track service cost with cost type/amount on Premium; Block extra time after appointment on Plus/Premium. Limit to documented service fields; no undocumented commission-editor controls.

  MCP callsquare_appointments_write → service_cost_and_buffer_settings

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/cost-and-buffer-settings/service

  Parameters

  No parameters.

  Example response

  {
    "scope": "Desktop service editor: Track service cost with cost type/amount on Premium; Block extra time after appointment on Plus/Premium. Limit to documented service fields; no undocumented commission-editor controls"
  }

• manage_service_processing_time_and_colors Set service processing time and calendar color. Desktop Service library > service: toggle Add processing time (Plus/Premium); click image to choose a color; then Calendar gear > View calendar by service. Only fields in the 6487 body; the processing-time article is not supplied. writeAsks first

  Set service processing time and calendar color. Desktop Service library > service: toggle Add processing time (Plus/Premium); click image to choose a color; then Calendar gear > View calendar by service. Only fields in the 6487 body; the processing-time article is not supplied.

  MCP callsquare_appointments_write → manage_service_processing_time_and_colors

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/service-processing-time-and-colors/manage

  Parameters

  No parameters.

  Example response

  {
    "scope": "Desktop Service library > service: toggle Add processing time (Plus/Premium); click image to choose a color; then Calendar gear > View calendar by service. Only fields in the 6487 body; the processing-time article is not supplied"
  }

• change_appointment_resource Change the resource booked on an appointment. Desktop Calendar > appointment > Edit > service > Resource dropdown > Save; Premium resource booking. writeAsks first

  Change the resource booked on an appointment. Desktop Calendar > appointment > Edit > service > Resource dropdown > Save; Premium resource booking.

  MCP callsquare_appointments_write → change_appointment_resource

  REST endpointPATCH https://cotlet.dev/api/v1/square-appointments/appointment-resource

  Parameters

  No parameters.

  Example response

  {
    "scope": "Desktop Calendar > appointment > Edit > service > Resource dropdown > Save; Premium resource booking"
  }

• edit_delete_resources Edit or delete a resource. Desktop Items > Resources > select > edit and Save, or ... > Delete > Delete Resource. A resource belongs to one location. Premium. writeAsks first

  Edit or delete a resource. Desktop Items > Resources > select > edit and Save, or ... > Delete > Delete Resource. A resource belongs to one location. Premium.

  MCP callsquare_appointments_write → edit_delete_resources

  REST endpointPATCH https://cotlet.dev/api/v1/square-appointments/delete-resources

  Parameters

  No parameters.

  Example response

  {
    "scope": "Desktop Items > Resources > select > edit and Save, or ... > Delete > Delete Resource. A resource belongs to one location. Premium"
  }

ToolWhat it doesAccess

• cancel_or_no_show_appointment Cancel an appointment or mark it no-show, choosing client notification. Desktop Dashboard Appointments > Settings > History > appointment > More. Choose notification and confirm. Article requires account & settings permission to edit business information; eligible Appointments plans or advanced bookings. writeAsks first

  Cancel an appointment or mark it no-show, choosing client notification. Desktop Dashboard Appointments > Settings > History > appointment > More. Choose notification and confirm. Article requires account & settings permission to edit business information; eligible Appointments plans or advanced bookings.

  MCP callsquare_appointments_write → cancel_or_no_show_appointment

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/or-no-show-appointment/cancel

  Parameters

  No parameters.

  Example response

  {
    "scope": "Desktop Dashboard Appointments > Settings > History > appointment > More. Choose notification and confirm. Article requires account & settings permission to edit business information; eligible Appointments plans or advanced bookings"
  }

• review_past_appointments View and edit documented past appointment details. Desktop Settings > History > appointment > click detail > Save. No unspecified actions; cancellation and payment are separate functions. Account & settings permission specified by article. writeAsks first

  View and edit documented past appointment details. Desktop Settings > History > appointment > click detail > Save. No unspecified actions; cancellation and payment are separate functions. Account & settings permission specified by article.

  MCP callsquare_appointments_write → review_past_appointments

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/past-appointments/review

  Parameters

  No parameters.

  Example response

  {
    "scope": "Desktop Settings > History > appointment > click detail > Save. No unspecified actions; cancellation and payment are separate functions. Account & settings permission specified by article"
  }

• appointment_communications_settings Configure business-level confirmation requests and SMS/email reminder timing. Desktop Settings > Communications > Save. Confirmation request: text, email or both, 2 hours-1 week before; reminders: 1 hour-3 days before. Customer-specific preferences and templates are separate additions. writeAsks first

  Configure business-level confirmation requests and SMS/email reminder timing. Desktop Settings > Communications > Save. Confirmation request: text, email or both, 2 hours-1 week before; reminders: 1 hour-3 days before. Customer-specific preferences and templates are separate additions.

  MCP callsquare_appointments_write → appointment_communications_settings

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/communications-settings/appointment

  Parameters

  No parameters.

  Example response

  {
    "scope": "Desktop Settings > Communications > Save. Confirmation request: text, email or both, 2 hours-1 week before; reminders: 1 hour-3 days before. Customer-specific preferences and templates are separate additions"
  }

• set_appointment_acceptance_requirement Require manual acceptance of online appointment requests (Reservation Guarantee setting). Dashboard Appointments > Settings > Calendar & Booking > Online Booking Preferences > Reservation Guarantee > 'Business must accept or decline all appointment requests', then Save. Changes how online bookings behave for the public. Square's wording of the settings path varies by page. writeAsks first

  Require manual acceptance of online appointment requests (Reservation Guarantee setting). Dashboard Appointments > Settings > Calendar & Booking > Online Booking Preferences > Reservation Guarantee > 'Business must accept or decline all appointment requests', then Save. Changes how online bookings behave for the public. Square's wording of the settings path varies by page.

  MCP callsquare_appointments_write → set_appointment_acceptance_requirement

  REST endpointPUT https://cotlet.dev/api/v1/square-appointments/appointment-acceptance-requirement

  Parameters

  No parameters.

  Example response

  {
    "scope": "Dashboard Appointments > Settings > Calendar & Booking > Online Booking Preferences > Reservation Guarantee > 'Business must accept or decline all appointment requests', then Save. Changes how online bookings behave for the public. Square's wording of the settings path varies by page"
  }

• accept_or_decline_pending_appointment Accept or decline pending appointment requests, with an optional email or text message to the client. Dashboard Appointments > Overview > Notifications, or Calendar > select pending appointment > Accept or Decline > choose email or text > optional message > Send. Also in the Square Appointments POS app and Square POS with bookings mode. Sends a client notification. Declined requests drop off the calendar; accepted requests are confirmed. writeAsks first

  Accept or decline pending appointment requests, with an optional email or text message to the client. Dashboard Appointments > Overview > Notifications, or Calendar > select pending appointment > Accept or Decline > choose email or text > optional message > Send. Also in the Square Appointments POS app and Square POS with bookings mode. Sends a client notification. Declined requests drop off the calendar; accepted requests are confirmed.

  MCP callsquare_appointments_write → accept_or_decline_pending_appointment

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/or-decline-pending-appointment/accept

  Parameters

  No parameters.

  Example response

  {
    "scope": "Dashboard Appointments > Overview > Notifications, or Calendar > select pending appointment > Accept or Decline > choose email or text > optional message > Send. Also in the Square Appointments POS app and Square POS with bookings mode. Sends a client notification. Declined requests drop off the calendar; accepted requests are confirmed"
  }

• enable_waitlist Enable the appointments waitlist on the online booking site and set opening notifications. Account owner or team member with the appointments permission to configure appointment settings. Dashboard Appointments > Online Booking > Settings > Waitlist toggles, then Save. Applies to all locations. Needs an existing online booking site. Appointments Plus/Premium, or Square Plus/Premium with advanced bookings capabilities. Automated opening notifications go to clients by SMS and email. writeAsks first

  Enable the appointments waitlist on the online booking site and set opening notifications. Account owner or team member with the appointments permission to configure appointment settings. Dashboard Appointments > Online Booking > Settings > Waitlist toggles, then Save. Applies to all locations. Needs an existing online booking site. Appointments Plus/Premium, or Square Plus/Premium with advanced bookings capabilities. Automated opening notifications go to clients by SMS and email.

  MCP callsquare_appointments_write → enable_waitlist

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/waitlist/enable

  Parameters

  No parameters.

  Example response

  {
    "scope": "Account owner or team member with the appointments permission to configure appointment settings. Dashboard Appointments > Online Booking > Settings > Waitlist toggles, then Save. Applies to all locations. Needs an existing online booking site. Appointments Plus/Premium, or Square Plus/Premium with advanced bookings capabilities. Automated opening notifications go to clients by SMS and email"
  }

• view_waitlist View the waitlist and open an entry's details. Dashboard Appointments > Waitlist, or Appointments POS app > More > Waitlist. Appointments Plus/Premium, or Square Plus/Premium with advanced bookings capabilities. read

  View the waitlist and open an entry's details. Dashboard Appointments > Waitlist, or Appointments POS app > More > Waitlist. Appointments Plus/Premium, or Square Plus/Premium with advanced bookings capabilities.

  MCP callsquare_appointments_read → view_waitlist

  REST endpointGET https://cotlet.dev/api/v1/square-appointments/waitlists/view

  Parameters

  No parameters.

  Example response

  {
    "scope": "Dashboard Appointments > Waitlist, or Appointments POS app > More > Waitlist. Appointments Plus/Premium, or Square Plus/Premium with advanced bookings capabilities"
  }

• add_waitlist_request Add a customer waitlist request from Dashboard. Desktop Appointments > Waitlist > optional location > Add request > customer details and requested services > Save. Do not substitute the mobile Add to waitlist control. No class waitlist. writeAsks first

  Add a customer waitlist request from Dashboard. Desktop Appointments > Waitlist > optional location > Add request > customer details and requested services > Save. Do not substitute the mobile Add to waitlist control. No class waitlist.

  MCP callsquare_appointments_write → add_waitlist_request

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/waitlist-requests

  Parameters

  No parameters.

  Example response

  {
    "scope": "Desktop Appointments > Waitlist > optional location > Add request > customer details and requested services > Save. Do not substitute the mobile Add to waitlist control. No class waitlist"
  }

• edit_or_remove_waitlist_request Edit a waitlist request (staff notes, client availability) or remove it. Dashboard Appointments > Waitlist > entry menu (...), or Appointments POS app. Removing a request is a deletion. Plus/Premium. writeAsks first

  Edit a waitlist request (staff notes, client availability) or remove it. Dashboard Appointments > Waitlist > entry menu (...), or Appointments POS app. Removing a request is a deletion. Plus/Premium.

  MCP callsquare_appointments_write → edit_or_remove_waitlist_request

  REST endpointPATCH https://cotlet.dev/api/v1/square-appointments/or-remove-waitlist-request

  Parameters

  No parameters.

  Example response

  {
    "scope": "Dashboard Appointments > Waitlist > entry menu (...), or Appointments POS app. Removing a request is a deletion. Plus/Premium"
  }

• message_waitlist_clients Message waitlisted clients through Messages. Dashboard Messages or Appointments POS app, from the waitlist flow (optional step). External send to clients; requires Messages setup and contact consent. Plus/Premium. writeAsks first

  Message waitlisted clients through Messages. Dashboard Messages or Appointments POS app, from the waitlist flow (optional step). External send to clients; requires Messages setup and contact consent. Plus/Premium.

  MCP callsquare_appointments_write → message_waitlist_clients

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/waitlist-clients/message

  Parameters

  No parameters.

  Example response

  {
    "scope": "Dashboard Messages or Appointments POS app, from the waitlist flow (optional step). External send to clients; requires Messages setup and contact consent. Plus/Premium"
  }

• enable_multi_staff_booking Turn multi-staff appointment booking on or off ('Allow multiple staff to be booked in a single appointment'). Account owner or team member with the appointments permission to configure appointment settings. Dashboard Appointments (AU/IE variants: Settings > Calendar & booking) toggle. Appointments Plus/Premium, or Square Plus/Premium with advanced bookings capabilities; AU/IE/CA variants also name POS bookings mode. Turning it on lets clients book one appointment containing services assigned to different staff, which changes public booking behaviour. Turning it off does not stop staff from manually creating multi-staff appointments. writeAsks first

  Turn multi-staff appointment booking on or off ('Allow multiple staff to be booked in a single appointment'). Account owner or team member with the appointments permission to configure appointment settings. Dashboard Appointments (AU/IE variants: Settings > Calendar & booking) toggle. Appointments Plus/Premium, or Square Plus/Premium with advanced bookings capabilities; AU/IE/CA variants also name POS bookings mode. Turning it on lets clients book one appointment containing services assigned to different staff, which changes public booking behaviour. Turning it off does not stop staff from manually creating multi-staff appointments.

  MCP callsquare_appointments_write → enable_multi_staff_booking

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/multi-staff-booking/enable

  Parameters

  No parameters.

  Example response

  {
    "scope": "Account owner or team member with the appointments permission to configure appointment settings. Dashboard Appointments (AU/IE variants: Settings > Calendar & booking) toggle. Appointments Plus/Premium, or Square Plus/Premium with advanced bookings capabilities; AU/IE/CA variants also name POS bookings mode. Turning it on lets clients book one appointment containing services assigned to different staff, which changes public booking behaviour. Turning it off does not stop staff from manually creating multi-staff appointments"
  }

• schedule_multi_staff_appointment Schedule an appointment with multiple staff members and reassign the staff member for an item. Requires multi-staff booking to be enabled first. From Square Dashboard Appointments (Create Appointment > Add a service > staff dropdown), Square Appointments POS app or Square Point of Sale app. The article also says the staff member assigned to an item on an existing booked appointment can be updated. Tips for multi-staff appointments may need the appointment split into separate transactions (payment side, not part of this function). Plus/Premium. Client notification applies as with any appointment. writeAsks first

  Schedule an appointment with multiple staff members and reassign the staff member for an item. Requires multi-staff booking to be enabled first. From Square Dashboard Appointments (Create Appointment > Add a service > staff dropdown), Square Appointments POS app or Square Point of Sale app. The article also says the staff member assigned to an item on an existing booked appointment can be updated. Tips for multi-staff appointments may need the appointment split into separate transactions (payment side, not part of this function). Plus/Premium. Client notification applies as with any appointment.

  MCP callsquare_appointments_write → schedule_multi_staff_appointment

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/multi-staff-appointment/schedule

  Parameters

  No parameters.

  Example response

  {
    "scope": "Requires multi-staff booking to be enabled first. From Square Dashboard Appointments (Create Appointment > Add a service > staff dropdown), Square Appointments POS app or Square Point of Sale app. The article also says the staff member assigned to an item on an existing booked appointment can be updated. Tips for multi-staff appointments may need the appointment split into separate transactions (payment side, not part of this function). Plus/Premium. Client notification applies as with any appointment"
  }

• create_schedule_class Create and schedule a class (single or recurring) with location, date, time, repetition, spots and instructor. Dashboard Appointments > Calendar > Create (Class schedule), Appointments POS app (Calendar > + > Create Class), or Square POS with bookings mode. Class booking needs Square Plus/Premium with advanced bookings capabilities, or Appointments Plus/Premium. Classes appear on the online booking site, so this publishes bookable inventory. writeAsks first

  Create and schedule a class (single or recurring) with location, date, time, repetition, spots and instructor. Dashboard Appointments > Calendar > Create (Class schedule), Appointments POS app (Calendar > + > Create Class), or Square POS with bookings mode. Class booking needs Square Plus/Premium with advanced bookings capabilities, or Appointments Plus/Premium. Classes appear on the online booking site, so this publishes bookable inventory.

  MCP callsquare_appointments_write → create_schedule_class

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/schedule-class

  Parameters

  No parameters.

  Example response

  {
    "scope": "Dashboard Appointments > Calendar > Create (Class schedule), Appointments POS app (Calendar > + > Create Class), or Square POS with bookings mode. Class booking needs Square Plus/Premium with advanced bookings capabilities, or Appointments Plus/Premium. Classes appear on the online booking site, so this publishes bookable inventory"
  }

• edit_class Edit a class or add a new class schedule (date, time, repetition, capacity, instructor). Dashboard Appointments > Calendar > select a session > (...) > Edit or Add new class schedule. Same plan requirement as class creation. Per the help article, changing date, time, location or duration automatically cancels and refunds existing bookings, which is a client-facing change and a refund side effect. For recurring classes, date, time and repetition cannot be edited. writeAsks first

  Edit a class or add a new class schedule (date, time, repetition, capacity, instructor). Dashboard Appointments > Calendar > select a session > (...) > Edit or Add new class schedule. Same plan requirement as class creation. Per the help article, changing date, time, location or duration automatically cancels and refunds existing bookings, which is a client-facing change and a refund side effect. For recurring classes, date, time and repetition cannot be edited.

  MCP callsquare_appointments_write → edit_class

  REST endpointPATCH https://cotlet.dev/api/v1/square-appointments/class

  Parameters

  No parameters.

  Example response

  {
    "scope": "Dashboard Appointments > Calendar > select a session > (...) > Edit or Add new class schedule. Same plan requirement as class creation. Per the help article, changing date, time, location or duration automatically cancels and refunds existing bookings, which is a client-facing change and a refund side effect. For recurring classes, date, time and repetition cannot be edited"
  }

• cancel_class_sessions Cancel class sessions. The US article says a recurring series allows cancelling any single session or all scheduled classes going forward; no UI click path is supplied. Edits that change date, time, location or duration cancel and refund bookings. writeAsks first

  Cancel class sessions. The US article says a recurring series allows cancelling any single session or all scheduled classes going forward; no UI click path is supplied. Edits that change date, time, location or duration cancel and refund bookings.

  MCP callsquare_appointments_write → cancel_class_sessions

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/class-sessions/cancel

  Parameters

  No parameters.

  Example response

  {
    "scope": "The US article says a recurring series allows cancelling any single session or all scheduled classes going forward; no UI click path is supplied. Edits that change date, time, location or duration cancel and refund bookings"
  }

• add_class_attendee Book a client into a class in person (Add attendee, select or create a client). Dashboard Appointments > class session > Add attendee, or POS apps. Plus/Premium. The booking step is retained. Taking a payment for the attendee is a money movement and is not part of this function. Creating a client creates a customer record. writeAsks first

  Book a client into a class in person (Add attendee, select or create a client). Dashboard Appointments > class session > Add attendee, or POS apps. Plus/Premium. The booking step is retained. Taking a payment for the attendee is a money movement and is not part of this function. Creating a client creates a customer record.

  MCP callsquare_appointments_write → add_class_attendee

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/class-attendees

  Parameters

  No parameters.

  Example response

  {
    "scope": "Dashboard Appointments > class session > Add attendee, or POS apps. Plus/Premium. The booking step is retained. Taking a payment for the attendee is a money movement and is not part of this function. Creating a client creates a customer record"
  }

• edit_existing_appointment Open and edit existing staff appointments. Owner or permitted team member; desktop Calendar > optional location > Side-by-side > Staff > appointment. Change exposed appointment details only; no undocumented drag/drop or bulk controls. writeAsks first

  Open and edit existing staff appointments. Owner or permitted team member; desktop Calendar > optional location > Side-by-side > Staff > appointment. Change exposed appointment details only; no undocumented drag/drop or bulk controls.

  MCP callsquare_appointments_write → edit_existing_appointment

  REST endpointPATCH https://cotlet.dev/api/v1/square-appointments/existing-appointment

  Parameters

  No parameters.

  Example response

  {
    "scope": "Owner or permitted team member; desktop Calendar > optional location > Side-by-side > Staff > appointment. Change exposed appointment details only; no undocumented drag/drop or bulk controls"
  }

• customize_appointment_notification_templates Customize appointment notification email and SMS templates. Desktop Communications > Custom notifications: new, confirmation/reminder, change and cancellation templates. Email subject/message, SMS message and bracketed variables; no promotional content. writeAsks first

  Customize appointment notification email and SMS templates. Desktop Communications > Custom notifications: new, confirmation/reminder, change and cancellation templates. Email subject/message, SMS message and bracketed variables; no promotional content.

  MCP callsquare_appointments_write → customize_appointment_notification_templates

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/appointment-notification-templates/customize

  Parameters

  No parameters.

  Example response

  {
    "scope": "Desktop Communications > Custom notifications: new, confirmation/reminder, change and cancellation templates. Email subject/message, SMS message and bracketed variables; no promotional content"
  }

• square_assistant_do_not_disturb Enable or disable Square Assistant Do not disturb. Desktop Appointments > Settings > Communications > Square Assistant, or Messages settings > Do not disturb > Save; customers permission. writeAsks first

  Enable or disable Square Assistant Do not disturb. Desktop Appointments > Settings > Communications > Square Assistant, or Messages settings > Do not disturb > Save; customers permission.

  MCP callsquare_appointments_write → square_assistant_do_not_disturb

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/assistant-do-not-disturb/square

  Parameters

  No parameters.

  Example response

  {
    "scope": "Desktop Appointments > Settings > Communications > Square Assistant, or Messages settings > Do not disturb > Save; customers permission"
  }

• read_google_booking_origin Identify appointments booked through Google. Read booking origin in Calendar appointment details; email notification is another documented surface, not a new inbox integration. read

  Identify appointments booked through Google. Read booking origin in Calendar appointment details; email notification is another documented surface, not a new inbox integration.

  MCP callsquare_appointments_read → read_google_booking_origin

  REST endpointGET https://cotlet.dev/api/v1/square-appointments/google-booking-origins/read

  Parameters

  No parameters.

  Example response

  {
    "scope": "Read booking origin in Calendar appointment details; email notification is another documented surface, not a new inbox integration"
  }

ToolWhat it doesAccess

• online_booking_setup Create, publish and preview a booking site; obtain booking URL, button or embed. Desktop Online Booking > Channels or Site Preview. Includes location selection, publication and customized booking-button HTML. Existing-site installation requires access to that site; no generic ecommerce administration imported. writeAsks first

  Create, publish and preview a booking site; obtain booking URL, button or embed. Desktop Online Booking > Channels or Site Preview. Includes location selection, publication and customized booking-button HTML. Existing-site installation requires access to that site; no generic ecommerce administration imported.

  MCP callsquare_appointments_write → online_booking_setup

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/booking-setup/online

  Parameters

  No parameters.

  Example response

  {
    "scope": "Desktop Online Booking > Channels or Site Preview. Includes location selection, publication and customized booking-button HTML. Existing-site installation requires access to that site; no generic ecommerce administration imported"
  }

• manage_booking_add_ons Create and attach optional or required booking add-ons. Desktop Modifiers > create set; modifier name, price and duration; enable Online Booking. Attach sets under service Modifiers and choose Optional or Required. Changes are immediately public; maintenance is separately added. writeAsks first

  Create and attach optional or required booking add-ons. Desktop Modifiers > create set; modifier name, price and duration; enable Online Booking. Attach sets under service Modifiers and choose Optional or Required. Changes are immediately public; maintenance is separately added.

  MCP callsquare_appointments_write → manage_booking_add_ons

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/booking-add-ons/manage

  Parameters

  No parameters.

  Example response

  {
    "scope": "Desktop Modifiers > create set; modifier name, price and duration; enable Online Booking. Attach sets under service Modifiers and choose Optional or Required. Changes are immediately public; maintenance is separately added"
  }

• customize_booking_site_content Add or edit booking-site announcement banner and location section, and arrange services. Dashboard Channels > Square Online > Website > Edit Site > Appointments page; banner and Location and hours sections; publish required. Category order is managed via Edit service display (see 8425). The article also names arranging and adding or deleting services without steps. writeAsks first

  Add or edit booking-site announcement banner and location section, and arrange services. Dashboard Channels > Square Online > Website > Edit Site > Appointments page; banner and Location and hours sections; publish required. Category order is managed via Edit service display (see 8425). The article also names arranging and adding or deleting services without steps.

  MCP callsquare_appointments_write → customize_booking_site_content

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/booking-site-content/customize

  Parameters

  No parameters.

  Example response

  {
    "scope": "Dashboard Channels > Square Online > Website > Edit Site > Appointments page; banner and Location and hours sections; publish required. Category order is managed via Edit service display (see 8425). The article also names arranging and adding or deleting services without steps"
  }

• manage_booking_site_branding_and_service_display Manage booking branding, team profiles, business links, categories and image display. Use documented desktop paths: Online editor > Site design > Colors; Account & Settings > Payments > Receipts > Apply branding for Appointments-hosted branding; Staff > Team > Appointments > Online booking profile; My business > Locations for business/social details; Items for service/category images and categories; Channels > Edit service display for ordering and image/name toggles. No inherited unsupported Online booking profile branding path. writeAsks first

  Manage booking branding, team profiles, business links, categories and image display. Use documented desktop paths: Online editor > Site design > Colors; Account & Settings > Payments > Receipts > Apply branding for Appointments-hosted branding; Staff > Team > Appointments > Online booking profile; My business > Locations for business/social details; Items for service/category images and categories; Channels > Edit service display for ordering and image/name toggles. No inherited unsupported Online booking profile branding path.

  MCP callsquare_appointments_write → manage_booking_site_branding_and_service_display

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/booking-site-branding-and-service-display/manage

  Parameters

  No parameters.

  Example response

  {
    "scope": "Use documented desktop paths: Online editor > Site design > Colors; Account & Settings > Payments > Receipts > Apply branding for Appointments-hosted branding; Staff > Team > Appointments > Online booking profile; My business > Locations for business/social details; Items for service/category images and categories; Channels > Edit service display for ordering and image/name toggles. No inherited unsupported Online booking profile branding path"
  }

• manage_booking_customer_profile_fields Add or remove booking customer profile fields. Dashboard Appointments > Online booking > Settings > Customer profile fields: add an existing field for appointments or classes (max 5, optional), or remove it via the trash icon. Plan is stated inconsistently on the page, so say 'plan per page' rather than 'Free'. writeAsks first

  Add or remove booking customer profile fields. Dashboard Appointments > Online booking > Settings > Customer profile fields: add an existing field for appointments or classes (max 5, optional), or remove it via the trash icon. Plan is stated inconsistently on the page, so say 'plan per page' rather than 'Free'.

  MCP callsquare_appointments_write → manage_booking_customer_profile_fields

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/booking-customer-profile-fields/manage

  Parameters

  No parameters.

  Example response

  {
    "scope": "Dashboard Appointments > Online booking > Settings > Customer profile fields: add an existing field for appointments or classes (max 5, optional), or remove it via the trash icon. Plan is stated inconsistently on the page, so say 'plan per page' rather than 'Free'"
  }

• view_booking_customer_profile_fields View customer profile fields on appointments, classes and the customer profile. Appointment or class details under Customer, and the Customer Directory profile. Fields appear only if the customer filled them in during online booking. Plus/Premium. read

  View customer profile fields on appointments, classes and the customer profile. Appointment or class details under Customer, and the Customer Directory profile. Fields appear only if the customer filled them in during online booking. Plus/Premium.

  MCP callsquare_appointments_read → view_booking_customer_profile_fields

  REST endpointGET https://cotlet.dev/api/v1/square-appointments/booking-customer-profile-fields/view

  Parameters

  No parameters.

  Example response

  {
    "scope": "Appointment or class details under Customer, and the Customer Directory profile. Fields appear only if the customer filled them in during online booking. Plus/Premium"
  }

• booking_timezone_and_staff_choice_settings Set booking timezone, Any Available staff, multiple services and staff-name visibility. Desktop Calendar & booking > Save. Allow customer timezone or lock to business; toggle Any Available, multiple services and Remove staff from online booking site. Removing staff mentions does not remove internal assignment. writeAsks first

  Set booking timezone, Any Available staff, multiple services and staff-name visibility. Desktop Calendar & booking > Save. Allow customer timezone or lock to business; toggle Any Available, multiple services and Remove staff from online booking site. Removing staff mentions does not remove internal assignment.

  MCP callsquare_appointments_write → booking_timezone_and_staff_choice_settings

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/timezone-and-staff-choice-settings/booking

  Parameters

  No parameters.

  Example response

  {
    "scope": "Desktop Calendar & booking > Save. Allow customer timezone or lock to business; toggle Any Available, multiple services and Remove staff from online booking site. Removing staff mentions does not remove internal assignment"
  }

• disable_online_booking Disable the online booking site. Desktop Online Booking > Channels > Enable online booking OFF > Confirm. writeAsks first

  Disable the online booking site. Desktop Online Booking > Channels > Enable online booking OFF > Confirm.

  MCP callsquare_appointments_write → disable_online_booking

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/online-booking/disable

  Parameters

  No parameters.

  Example response

  {
    "scope": "Desktop Online Booking > Channels > Enable online booking OFF > Confirm"
  }

• manage_advanced_booking_widgets Create, edit, copy embed code for and delete advanced booking widgets. Desktop Online Booking > Advanced widget > location > Create New Widget for Location; name, services and staff > Save. Edits propagate to installed widgets; deletion does not remove external code and leaves an error there. All variations display irrespective of Online Booking settings. writeAsks first

  Create, edit, copy embed code for and delete advanced booking widgets. Desktop Online Booking > Advanced widget > location > Create New Widget for Location; name, services and staff > Save. Edits propagate to installed widgets; deletion does not remove external code and leaves an error there. All variations display irrespective of Online Booking settings.

  MCP callsquare_appointments_write → manage_advanced_booking_widgets

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/advanced-booking-widgets/manage

  Parameters

  No parameters.

  Example response

  {
    "scope": "Desktop Online Booking > Advanced widget > location > Create New Widget for Location; name, services and staff > Save. Edits propagate to installed widgets; deletion does not remove external code and leaves an error there. All variations display irrespective of Online Booking settings"
  }

• send_booking_invitations Compose and send online-booking invitation campaigns. Desktop Online Booking > Invite clients > Create Campaign. Add names/emails or existing clients, remove recipients, edit copy, choose website/booking-site destination, review and Send. New details create client profiles. writeAsks first

  Compose and send online-booking invitation campaigns. Desktop Online Booking > Invite clients > Create Campaign. Add names/emails or existing clients, remove recipients, edit copy, choose website/booking-site destination, review and Send. New details create client profiles.

  MCP callsquare_appointments_write → send_booking_invitations

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/booking-invitations

  Parameters

  No parameters.

  Example response

  {
    "scope": "Desktop Online Booking > Invite clients > Create Campaign. Add names/emails or existing clients, remove recipients, edit copy, choose website/booking-site destination, review and Send. New details create client profiles"
  }

• manage_reserve_with_google Request activation or deactivate Reserve with Google. Desktop Channels > Reserve with Google > Get Started, verify matching business address > Request Activation > Confirm Request; Manage > Deactivate to disconnect. Existing authorized Google session required; no credential editing. Requires online booking and claimed eligible business; no classes, multi-service booking, prepayment or no-show protection; bookings auto-accepted. writeAsks first

  Request activation or deactivate Reserve with Google. Desktop Channels > Reserve with Google > Get Started, verify matching business address > Request Activation > Confirm Request; Manage > Deactivate to disconnect. Existing authorized Google session required; no credential editing. Requires online booking and claimed eligible business; no classes, multi-service booking, prepayment or no-show protection; bookings auto-accepted.

  MCP callsquare_appointments_write → manage_reserve_with_google

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/reserve-with-google/manage

  Parameters

  No parameters.

  Example response

  {
    "scope": "Desktop Channels > Reserve with Google > Get Started, verify matching business address > Request Activation > Confirm Request; Manage > Deactivate to disconnect. Existing authorized Google session required; no credential editing. Requires online booking and claimed eligible business; no classes, multi-service booking, prepayment or no-show protection; bookings auto-accepted"
  }

• manage_facebook_booking_button Connect, test or delete a Facebook Book Now button. Facebook business page desktop: Add a Button > Book Now > Connect Another Tool > Appointments for Square; review authorization/account/button settings. Test Button; Edit Book Now > Delete Button twice. Requires business page and booking website. No classes; credential entry/account changes excluded. writeAsks first

  Connect, test or delete a Facebook Book Now button. Facebook business page desktop: Add a Button > Book Now > Connect Another Tool > Appointments for Square; review authorization/account/button settings. Test Button; Edit Book Now > Delete Button twice. Requires business page and booking website. No classes; credential entry/account changes excluded.

  MCP callsquare_appointments_write → manage_facebook_booking_button

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/facebook-booking-button/manage

  Parameters

  No parameters.

  Example response

  {
    "scope": "Facebook business page desktop: Add a Button > Book Now > Connect Another Tool > Appointments for Square; review authorization/account/button settings. Test Button; Edit Book Now > Delete Button twice. Requires business page and booking website. No classes; credential entry/account changes excluded"
  }

• manage_square_go_listing Review/edit Square Go listing and activate or opt out locations. Desktop Channels > Square Go > Get started/Manage profile. Location toggles, photos, business description, service/staff review, Google review display settings, location/cancellation-policy review. Changes immediately live. Eligible US beauty/personal-care businesses, online booking and recent booking required. Opt-out hides discovery, not existing-client booking management. writeAsks first

  Review/edit Square Go listing and activate or opt out locations. Desktop Channels > Square Go > Get started/Manage profile. Location toggles, photos, business description, service/staff review, Google review display settings, location/cancellation-policy review. Changes immediately live. Eligible US beauty/personal-care businesses, online booking and recent booking required. Opt-out hides discovery, not existing-client booking management.

  MCP callsquare_appointments_write → manage_square_go_listing

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/square-go-listing/manage

  Parameters

  No parameters.

  Example response

  {
    "scope": "Desktop Channels > Square Go > Get started/Manage profile. Location toggles, photos, business description, service/staff review, Google review display settings, location/cancellation-policy review. Changes immediately live. Eligible US beauty/personal-care businesses, online booking and recent booking required. Opt-out hides discovery, not existing-client booking management"
  }

ToolWhat it doesAccess

• square_assistant_settings Enable, disable and manage Square Assistant (automated SMS confirm/cancel/reschedule replies). Account owner or team member with the customers permission. Dashboard Appointments > Settings > Communications > Square Assistant, toggle, then Save. Included free with Square Appointments, on by default for most sellers using Appointments online booking, and sends automated client messages. writeAsks first

  Enable, disable and manage Square Assistant (automated SMS confirm/cancel/reschedule replies). Account owner or team member with the customers permission. Dashboard Appointments > Settings > Communications > Square Assistant, toggle, then Save. Included free with Square Appointments, on by default for most sellers using Appointments online booking, and sends automated client messages.

  MCP callsquare_appointments_write → square_assistant_settings

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/assistant-settings/square

  Parameters

  No parameters.

  Example response

  {
    "scope": "Account owner or team member with the customers permission. Dashboard Appointments > Settings > Communications > Square Assistant, toggle, then Save. Included free with Square Appointments, on by default for most sellers using Appointments online booking, and sends automated client messages"
  }

ToolWhat it doesAccess

• messages_inbox_read Read appointment-related client conversations in Messages. Desktop Square Dashboard Messages; read customer texts and emails, appointment questions, confirmations, cancellations and rescheduling conversations. Staff need Messages permission and access to the correct location. read

  Read appointment-related client conversations in Messages. Desktop Square Dashboard Messages; read customer texts and emails, appointment questions, confirmations, cancellations and rescheduling conversations. Staff need Messages permission and access to the correct location.

  MCP callsquare_appointments_read → messages_inbox_read

  REST endpointGET https://cotlet.dev/api/v1/square-appointments/inbox-reads/messages

  Parameters

  No parameters.

  Example response

  {
    "scope": "Desktop Square Dashboard Messages; read customer texts and emails, appointment questions, confirmations, cancellations and rescheduling conversations. Staff need Messages permission and access to the correct location"
  }

• messages_send_to_customers Send appointment-related text and email messages to customers. Desktop Square Dashboard Messages; respond to client conversations from one inbox. Starting new conversations requires Square Plus or Premium; customer contact permissions and current messaging entitlement apply. writeAsks first

  Send appointment-related text and email messages to customers. Desktop Square Dashboard Messages; respond to client conversations from one inbox. Starting new conversations requires Square Plus or Premium; customer contact permissions and current messaging entitlement apply.

  MCP callsquare_appointments_write → messages_send_to_customers

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/send-to-customers/messages

  Parameters

  No parameters.

  Example response

  {
    "scope": "Desktop Square Dashboard Messages; respond to client conversations from one inbox. Starting new conversations requires Square Plus or Premium; customer contact permissions and current messaging entitlement apply"
  }

ToolWhat it doesAccess

• link_google_calendar Link a Google Calendar to the appointments calendar (import and export, import only, or export only). Account owner or team member with the appointments permission to configure appointment settings. Dashboard Appointments > Settings > Calendar & booking > Manage calendar sync > Link Google Calendar. Appointments Plus/Premium. Requires granting Square access to a Google account. Imported busy events block time on the appointments calendar (across all locations for multi-location staff). Only appointments sync to Google and only personal events sync from it. An event can be edited only in its calendar of origin. Outlook is not supported per a Square community answer. writeAsks first

  Link a Google Calendar to the appointments calendar (import and export, import only, or export only). Account owner or team member with the appointments permission to configure appointment settings. Dashboard Appointments > Settings > Calendar & booking > Manage calendar sync > Link Google Calendar. Appointments Plus/Premium. Requires granting Square access to a Google account. Imported busy events block time on the appointments calendar (across all locations for multi-location staff). Only appointments sync to Google and only personal events sync from it. An event can be edited only in its calendar of origin. Outlook is not supported per a Square community answer.

  MCP callsquare_appointments_write → link_google_calendar

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/google-calendar/link

  Parameters

  No parameters.

  Example response

  {
    "scope": "Account owner or team member with the appointments permission to configure appointment settings. Dashboard Appointments > Settings > Calendar & booking > Manage calendar sync > Link Google Calendar. Appointments Plus/Premium. Requires granting Square access to a Google account. Imported busy events block time on the appointments calendar (across all locations for multi-location staff). Only appointments sync to Google and only personal events sync from it. An event can be edited only in its calendar of origin. Outlook is not supported per a Square community answer"
  }

• refresh_or_remove_synced_calendar Refresh or remove a synced Google Calendar. Dashboard Appointments > Settings > Calendar & Booking > Manage Calendar Sync > (...) > Refresh Calendar or Remove Calendar. Removing a link is a deletion. Plus/Premium. The US article warns that events added to the synced calendar from Google can be lost on a re-sync. writeAsks first

  Refresh or remove a synced Google Calendar. Dashboard Appointments > Settings > Calendar & Booking > Manage Calendar Sync > (...) > Refresh Calendar or Remove Calendar. Removing a link is a deletion. Plus/Premium. The US article warns that events added to the synced calendar from Google can be lost on a re-sync.

  MCP callsquare_appointments_write → refresh_or_remove_synced_calendar

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/or-remove-synced-calendar/refresh

  Parameters

  No parameters.

  Example response

  {
    "scope": "Dashboard Appointments > Settings > Calendar & Booking > Manage Calendar Sync > (...) > Refresh Calendar or Remove Calendar. Removing a link is a deletion. Plus/Premium. The US article warns that events added to the synced calendar from Google can be lost on a re-sync"
  }

• create_personal_event Create a personal calendar event, optionally blocking time or recurring. Desktop Calendar > Create > Personal event. Title, notes, staff, dates/times, All day and Set repetition; Block time must be checked to remove booking availability. Imported events remain editable only at origin. writeAsks first

  Create a personal calendar event, optionally blocking time or recurring. Desktop Calendar > Create > Personal event. Title, notes, staff, dates/times, All day and Set repetition; Block time must be checked to remove booking availability. Imported events remain editable only at origin.

  MCP callsquare_appointments_write → create_personal_event

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/personal-events

  Parameters

  No parameters.

  Example response

  {
    "scope": "Desktop Calendar > Create > Personal event. Title, notes, staff, dates/times, All day and Set repetition; Block time must be checked to remove booking availability. Imported events remain editable only at origin"
  }

• set_calendar_view_filters Set calendar view attributes and display filters. Dashboard calendar gear: attribute icons including New client, view canceled, view by service, staff photos. Range/location/view/staff filters are listed in the article. Display-only; device specific. write

  Set calendar view attributes and display filters. Dashboard calendar gear: attribute icons including New client, view canceled, view by service, staff photos. Range/location/view/staff filters are listed in the article. Display-only; device specific.

  MCP callsquare_appointments_write → set_calendar_view_filters

  REST endpointPUT https://cotlet.dev/api/v1/square-appointments/calendar-view-filters

  Parameters

  No parameters.

  Example response

  {
    "scope": "Dashboard calendar gear: attribute icons including New client, view canceled, view by service, staff photos. Range/location/view/staff filters are listed in the article. Display-only; device specific"
  }

• export_appointment_history Export appointment history as CSV. Desktop Appointments > Settings > History > Export; download/save CSV. read

  Export appointment history as CSV. Desktop Appointments > Settings > History > Export; download/save CSV.

  MCP callsquare_appointments_read → export_appointment_history

  REST endpointGET https://cotlet.dev/api/v1/square-appointments/appointment-histories/export

  Parameters

  No parameters.

  Example response

  {
    "scope": "Desktop Appointments > Settings > History > Export; download/save CSV"
  }

ToolWhat it doesAccess

• take_appointment_or_class_payment Charge or record payment for an appointment or class attendee. Desktop Calendar appointment > Take Payment > supported method > Charge Card or Record Payment; History also supports payment. Class Add attendee permits immediate payment or deferral. Checkout permission; no mobile hardware-only controls. writeAsks first

  Charge or record payment for an appointment or class attendee. Desktop Calendar appointment > Take Payment > supported method > Charge Card or Record Payment; History also supports payment. Class Add attendee permits immediate payment or deferral. Checkout permission; no mobile hardware-only controls.

  MCP callsquare_appointments_write → take_appointment_or_class_payment

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/appointment-or-class-payment/take

  Parameters

  No parameters.

  Example response

  {
    "scope": "Desktop Calendar appointment > Take Payment > supported method > Charge Card or Record Payment; History also supports payment. Class Add attendee permits immediate payment or deferral. Checkout permission; no mobile hardware-only controls"
  }

• manage_booking_payment_and_cancellation_policies Configure prepayment, cancellation and no-show fee policies. Desktop Payments & cancellations: prepayment options, cutoff of 1 hour to 2 weeks or none, self-cancel toggle, no-show fees (flat per appointment, flat per service, percentage per service) and fee deletion. Class cancellation window is Dashboard-only per the class article. writeAsks first

  Configure prepayment, cancellation and no-show fee policies. Desktop Payments & cancellations: prepayment options, cutoff of 1 hour to 2 weeks or none, self-cancel toggle, no-show fees (flat per appointment, flat per service, percentage per service) and fee deletion. Class cancellation window is Dashboard-only per the class article.

  MCP callsquare_appointments_write → manage_booking_payment_and_cancellation_policies

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/booking-payment-and-cancellation-policies/manage

  Parameters

  No parameters.

  Example response

  {
    "scope": "Desktop Payments & cancellations: prepayment options, cutoff of 1 hour to 2 weeks or none, self-cancel toggle, no-show fees (flat per appointment, flat per service, percentage per service) and fee deletion. Class cancellation window is Dashboard-only per the class article"
  }

• enforce_cancellation_fee Enforce cancellation policy during eligible cancellation or modification handling. Applies when a client requests to cancel or modify outside the cutoff. Card is charged on enforcement, with an optional note in the customer email; fees can be charged up to 14 days after the appointment. No standalone charge button is documented. writeAsks first

  Enforce cancellation policy during eligible cancellation or modification handling. Applies when a client requests to cancel or modify outside the cutoff. Card is charged on enforcement, with an optional note in the customer email; fees can be charged up to 14 days after the appointment. No standalone charge button is documented.

  MCP callsquare_appointments_write → enforce_cancellation_fee

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/cancellation-fee/enforce

  Parameters

  No parameters.

  Example response

  {
    "scope": "Applies when a client requests to cancel or modify outside the cutoff. Card is charged on enforcement, with an optional note in the customer email; fees can be charged up to 14 days after the appointment. No standalone charge button is documented"
  }

• configure_appointment_deposits Require fixed or percentage appointment deposits. Desktop Settings > Payments & cancellations > current policy > Require a deposit. All fixed-price services or selected services with individual amounts; policy/refundability text and optional deposit tax collection on no-show/cancellation. Appointments Free/Plus/Premium. No seller-created-booking deposit collection. writeAsks first

  Require fixed or percentage appointment deposits. Desktop Settings > Payments & cancellations > current policy > Require a deposit. All fixed-price services or selected services with individual amounts; policy/refundability text and optional deposit tax collection on no-show/cancellation. Appointments Free/Plus/Premium. No seller-created-booking deposit collection.

  MCP callsquare_appointments_write → configure_appointment_deposits

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/appointment-deposits/configure

  Parameters

  No parameters.

  Example response

  {
    "scope": "Desktop Settings > Payments & cancellations > current policy > Require a deposit. All fixed-price services or selected services with individual amounts; policy/refundability text and optional deposit tax collection on no-show/cancellation. Appointments Free/Plus/Premium. No seller-created-booking deposit collection"
  }

• refund_appointment_deposit Refund an appointment deposit during cancellation or through Transactions. Before checkout, cancel or mark no-show and use offered refund option. After cancellation/no-show/full payment, open payment in Transactions > Issue refund. writeAsks first

  Refund an appointment deposit during cancellation or through Transactions. Before checkout, cancel or mark no-show and use offered refund option. After cancellation/no-show/full payment, open payment in Transactions > Issue refund.

  MCP callsquare_appointments_write → refund_appointment_deposit

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/appointment-deposit/refund

  Parameters

  No parameters.

  Example response

  {
    "scope": "Before checkout, cancel or mark no-show and use offered refund option. After cancellation/no-show/full payment, open payment in Transactions > Issue refund"
  }

ToolWhat it doesAccess

• manage_customer_booking_contact_preferences Update booking customer timezone and appointment notification preference. Desktop Directory > customer > Personal Information > Edit: Time Zone and Appointment Notifications (Email, or Email and Text Message). The supplied bodies do not establish contact-detail edits beyond this. SMS opt-in cannot be overridden. writeAsks first

  Update booking customer timezone and appointment notification preference. Desktop Directory > customer > Personal Information > Edit: Time Zone and Appointment Notifications (Email, or Email and Text Message). The supplied bodies do not establish contact-detail edits beyond this. SMS opt-in cannot be overridden.

  MCP callsquare_appointments_write → manage_customer_booking_contact_preferences

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/customer-booking-contact-preferences/manage

  Parameters

  No parameters.

  Example response

  {
    "scope": "Desktop Directory > customer > Personal Information > Edit: Time Zone and Appointment Notifications (Email, or Email and Text Message). The supplied bodies do not establish contact-detail edits beyond this. SMS opt-in cannot be overridden"
  }

ToolWhat it doesAccess

• read_package_catalog_and_customer_balances View package definitions and purchased-package balances. Desktop Items > Packages for definitions; Customers > Customer directory > customer > Packages for purchased packages, expiration and remaining credits. History and edits to sold quantity/expiration are withheld because current vendor text conflicts. read

  View package definitions and purchased-package balances. Desktop Items > Packages for definitions; Customers > Customer directory > customer > Packages for purchased packages, expiration and remaining credits. History and edits to sold quantity/expiration are withheld because current vendor text conflicts.

  MCP callsquare_appointments_read → read_package_catalog_and_customer_balances

  REST endpointGET https://cotlet.dev/api/v1/square-appointments/package-catalog-and-customer-balances/read

  Parameters

  No parameters.

  Example response

  {
    "scope": "Desktop Items > Packages for definitions; Customers > Customer directory > customer > Packages for purchased packages, expiration and remaining credits. History and edits to sold quantity/expiration are withheld because current vendor text conflicts"
  }

• manage_package_definitions Create, edit permitted package attributes and delete package offerings. Desktop Items > Packages; general items permission, eligible Plus/Premium. Create name/image/description, included services/classes/variations, price, sales channels and payment-link option. Existing quantity, inclusions and expiration cannot be edited. Other attribute edits affect existing/future purchases; price only future sales. Delete preserves purchased entitlements. writeAsks first

  Create, edit permitted package attributes and delete package offerings. Desktop Items > Packages; general items permission, eligible Plus/Premium. Create name/image/description, included services/classes/variations, price, sales channels and payment-link option. Existing quantity, inclusions and expiration cannot be edited. Other attribute edits affect existing/future purchases; price only future sales. Delete preserves purchased entitlements.

  MCP callsquare_appointments_write → manage_package_definitions

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/package-definitions/manage

  Parameters

  No parameters.

  Example response

  {
    "scope": "Desktop Items > Packages; general items permission, eligible Plus/Premium. Create name/image/description, included services/classes/variations, price, sales channels and payment-link option. Existing quantity, inclusions and expiration cannot be edited. Other attribute edits affect existing/future purchases; price only future sales. Delete preserves purchased entitlements"
  }

• sell_package_desktop Sell and charge for a package through Directory or Virtual Terminal. Desktop customer > Sell package, or Virtual terminal > Take a Payment > Itemized sale. Select package, customer with valid email/phone, payment method > Charge. Eligible Plus/Premium and checkout/customer/items permissions. writeAsks first

  Sell and charge for a package through Directory or Virtual Terminal. Desktop customer > Sell package, or Virtual terminal > Take a Payment > Itemized sale. Select package, customer with valid email/phone, payment method > Charge. Eligible Plus/Premium and checkout/customer/items permissions.

  MCP callsquare_appointments_write → sell_package_desktop

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/package-desktop/sell

  Parameters

  No parameters.

  Example response

  {
    "scope": "Desktop customer > Sell package, or Virtual terminal > Take a Payment > Itemized sale. Select package, customer with valid email/phone, payment method > Charge. Eligible Plus/Premium and checkout/customer/items permissions"
  }

• publish_package_sales_channels Enable package website sales and obtain location-specific payment links. Desktop Items > Packages > package: Where it's sold website toggles > Save; publish site if necessary. Payment links > Manage link > location toggles > Get link > Done. Limited to package sales, not generic payment-link management. writeAsks first

  Enable package website sales and obtain location-specific payment links. Desktop Items > Packages > package: Where it's sold website toggles > Save; publish site if necessary. Payment links > Manage link > location toggles > Get link > Done. Limited to package sales, not generic payment-link management.

  MCP callsquare_appointments_write → publish_package_sales_channels

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/package-sales-channels/publish

  Parameters

  No parameters.

  Example response

  {
    "scope": "Desktop Items > Packages > package: Where it's sold website toggles > Save; publish site if necessary. Payment links > Manage link > location toggles > Get link > Done. Limited to package sales, not generic payment-link management"
  }

• redeem_package_desktop Apply package credit and record appointment/class payment. Desktop Calendar > appointment > Take Payment, or class Add attendee. Applicable package applies automatically; complete Record payment. For zero total choose Other. Eligible Plus/Premium; no package redemption on deposit-required services. writeAsks first

  Apply package credit and record appointment/class payment. Desktop Calendar > appointment > Take Payment, or class Add attendee. Applicable package applies automatically; complete Record payment. For zero total choose Other. Eligible Plus/Premium; no package redemption on deposit-required services.

  MCP callsquare_appointments_write → redeem_package_desktop

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/package-desktop/redeem

  Parameters

  No parameters.

  Example response

  {
    "scope": "Desktop Calendar > appointment > Take Payment, or class Add attendee. Applicable package applies automatically; complete Record payment. For zero total choose Other. Eligible Plus/Premium; no package redemption on deposit-required services"
  }

• refund_package_purchase Refund an entire package purchase or a specified amount. Desktop Transactions > package transaction > Issue Refund > Refund Items or Refund Amount; choose method, amount and reason > Issue refund. writeAsks first

  Refund an entire package purchase or a specified amount. Desktop Transactions > package transaction > Issue Refund > Refund Items or Refund Amount; choose method, amount and reason > Issue refund.

  MCP callsquare_appointments_write → refund_package_purchase

  REST endpointPOST https://cotlet.dev/api/v1/square-appointments/package-purchase/refund

  Parameters

  No parameters.

  Example response

  {
    "scope": "Desktop Transactions > package transaction > Issue Refund > Refund Items or Refund Amount; choose method, amount and reason > Issue refund"
  }

• remove_package_paid_class_attendee Remove a package-paid class attendee and select package refund method. Desktop Calendar > class > attendee > Remove from class. Update client notifications and select Refund method showing the paying package. No undocumented credit-adjustment control. writeAsks first

  Remove a package-paid class attendee and select package refund method. Desktop Calendar > class > attendee > Remove from class. Update client notifications and select Refund method showing the paying package. No undocumented credit-adjustment control.

  MCP callsquare_appointments_write → remove_package_paid_class_attendee

  REST endpointDELETE https://cotlet.dev/api/v1/square-appointments/package-paid-class-attendees

  Parameters

  No parameters.

  Example response

  {
    "scope": "Desktop Calendar > class > attendee > Remove from class. Update client notifications and select Refund method showing the paying package. No undocumented credit-adjustment control"
  }