Square Appointments MCP Server

Square Appointments combines a staff appointment book, services, online booking and a client waitlist.

Server MCP Terhosting

npx add-mcp 'https://cotlet.dev/mcp/v1/square-appointments'

Terpasang ke Claude Code, Codex, Cursor, dan lainnya

Dokumentasi

Cotlet · Integrations · How it works · Security · For developers · For automation agencies · Blog · API docs · Help center · Changelog · Contact · Pricing · Sign up

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

Square publishes a Bookings API. Buyer-level booking writes are available on Free; seller-level creation, updates and cancellation require Appointments Plus or Premium and the corresponding API permissions. Square provides an official MCP server. Its current Appointments tool coverage was not established in the vendor sources reviewed; the separately announced AI ordering integrations concern food and beverage orders.

Square Appointments is a scheduling and online-booking app for service businesses. Seller-level Bookings API writes require Plus or Premium. Square has an official MCP server; its Appointments coverage is unverified. Checked 12 November 2026. Cotlet provides 68 Cloud Browser capabilities for ChatGPT and Claude in your own account.

Free 7-day trial, no card
Unofficial, not affiliated with Square Appointments
Page: https://cotlet.dev/integrations/square-appointments-api-mcp-server

What can your AI agent do in Square Appointments?

Review the next day across staff calendars
Check a waiting client against an open slot
Prepare an appointment with the right staff member
Review pending appointment requests
Update the services shown on your booking page
Check the remaining places in a scheduled class

Does Square Appointments have an MCP server or an API?

Square publishes a Bookings API. Buyer-level booking writes are available on Free; seller-level creation, updates and cancellation require Appointments Plus or Premium and the corresponding API permissions.
Square provides an official MCP server. Its current Appointments tool coverage was not established in the vendor sources reviewed; the separately announced AI ordering integrations concern food and beverage orders.
Square Assistant handles supported appointment confirmation, cancellation and rescheduling replies by text when enabled.

What you need	Official connection	By hand	Cotlet
Account work	Documented scope	Your staff time	Your account screens
Connection setup	Vendor access conditions	Your own sign-in	Sign in, then connect your AI

How does the Square Appointments MCP server work?

Sign in to Square Appointments. Once, in a browser we host for you.
Connect your AI agent. One address in its settings.
Hand it the busywork. Review tomorrow's Square Appointments calendar for the location I select. List pending appointment requests and waitlist clients who could use an open slot. Prepare the proposed booking and message without sending them until I approve.

Cotlet never sees or stores your password.

How to connect Square Appointments to your AI agent

Sign in to Square Appointments in a Cloud Browser. Open Square Appointments in your Cotlet Cloud Browser and sign in with your own business account at squareup.com/login.
Add the Cotlet address. Enter https://cotlet.dev/mcp/v1 as the MCP server or connector URL in your agent.
Let the agent in. Chat apps open a Cotlet sign-in page. Editors, n8n and scripts send an API key made in the console.

Square Appointments shares the address https://cotlet.dev/mcp/v1 with every other app you enable, so one connector covers them all. Turned Square Appointments on after connecting? Refresh the connector and the 68 tools appear.

ChatGPT:

Settings > Apps & Connectors > Create
MCP server URL: https://cotlet.dev/mcp/v1/connect
Authentication: OAuth

Claude:

Settings > Connectors > Add custom connector
URL: https://cotlet.dev/mcp/v1/connect

Claude Code:
claude mcp add --transport http cotlet \
  https://cotlet.dev/mcp/v1 \
  --header "Authorization: Bearer $COTLET_API_KEY"

Cursor:

// ~/.cursor/mcp.json
{
  "mcpServers": {
    "cotlet": {
      "url": "https://cotlet.dev/mcp/v1",
      "headers": { "Authorization": "Bearer ${env:COTLET_API_KEY}" }
    }
  }
}

Codex:

# ~/.codex/config.toml
[mcp_servers.cotlet]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY"

n8n:

MCP Client Tool (inside an AI Agent)
Transport: HTTP Streamable
URL: https://cotlet.dev/mcp/v1
Auth: Bearer, <your key>
Tool: square_appointments_read

All 68 Square Appointments MCP tools

Services and staff setup

Create and schedule appointments (specific time, all day, or recurring). Set appointment location, intervals, advance limits, daily limit and Fake-it Filter.

Create and schedule appointments (specific time, all day, or recurring) (schedule_appointment, write, asks 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.
Set appointment location, intervals, advance limits, daily limit and Fake-it Filter (appointment_booking_rules, write, asks 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.
Create a bookable team member or make an existing team member bookable (add_bookable_team_member, write, asks 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.
Edit a bookable team member's appointments settings and access (edit_team_member_appointment_settings, write, asks 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.
Remove a team member from appointments (remove_team_member_from_appointments, write, asks 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.
View upcoming appointments for selected staff members on the calendar (view_staff_calendars, 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.
Edit bookable staff availability per week (one-time change or recurring schedule) (update_staff_availability, write, asks 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.
Create resources and assign eligible resources to services or variations (manage_bookable_resources, write, asks 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.
Create/edit services and variations, enable bookability, and import services (create_manage_services, write, asks 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.
Irreversibly convert whole-unit catalog items into services (convert_items_to_services, write, asks 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.
Track service cost and configure post-appointment blocked time (service_cost_and_buffer_settings, write, asks 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.
Set service processing time and calendar color (manage_service_processing_time_and_colors, write, asks 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.
Change the resource booked on an appointment (change_appointment_resource, write, asks first): Change the resource booked on an appointment. Desktop Calendar > appointment > Edit > service > Resource dropdown > Save; Premium resource booking.
Edit or delete a resource (edit_delete_resources, write, asks first): Edit or delete a resource. Desktop Items > Resources > select > edit and Save, or ... > Delete > Delete Resource. A resource belongs to one location. Premium.

Scheduling and requests

Cancel an appointment or mark it no-show, choosing client notification. View and edit documented past appointment details.

Cancel an appointment or mark it no-show, choosing client notification (cancel_or_no_show_appointment, write, asks 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.
View and edit documented past appointment details (review_past_appointments, write, asks 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.
Configure business-level confirmation requests and SMS/email reminder timing (appointment_communications_settings, write, asks 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.
Require manual acceptance of online appointment requests (Reservation Guarantee setting) (set_appointment_acceptance_requirement, write, asks 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.
Accept or decline pending appointment requests, with an optional email or text message to the client (accept_or_decline_pending_appointment, write, asks 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.
Enable the appointments waitlist on the online booking site and set opening notifications (enable_waitlist, write, asks 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.
View the waitlist and open an entry's details (view_waitlist, 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.
Add a customer waitlist request from Dashboard (add_waitlist_request, write, asks 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.
Edit a waitlist request (staff notes, client availability) or remove it (edit_or_remove_waitlist_request, write, asks 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.
Message waitlisted clients through Messages (message_waitlist_clients, write, asks 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.
Turn multi-staff appointment booking on or off ('Allow multiple staff to be booked in a single appointment') (enable_multi_staff_booking, write, asks 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.
Schedule an appointment with multiple staff members and reassign the staff member for an item (schedule_multi_staff_appointment, write, asks 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.
Create and schedule a class (single or recurring) with location, date, time, repetition, spots and instructor (create_schedule_class, write, asks 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.
Edit a class or add a new class schedule (date, time, repetition, capacity, instructor) (edit_class, write, asks 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.
Cancel class sessions (cancel_class_sessions, write, asks 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.
Book a client into a class in person (Add attendee, select or create a client) (add_class_attendee, write, asks 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.
Open and edit existing staff appointments (edit_existing_appointment, write, asks 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.
Customize appointment notification email and SMS templates (customize_appointment_notification_templates, write, asks 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.
Enable or disable Square Assistant Do not disturb (square_assistant_do_not_disturb, write, asks first): Enable or disable Square Assistant Do not disturb. Desktop Appointments > Settings > Communications > Square Assistant, or Messages settings > Do not disturb > Save; customers permission.
Identify appointments booked through Google (read_google_booking_origin, read): Identify appointments booked through Google. Read booking origin in Calendar appointment details; email notification is another documented surface, not a new inbox integration.

Online booking and integrations

Create, publish and preview a booking site; obtain booking URL, button or embed. Create and attach optional or required booking add-ons.

Create, publish and preview a booking site; obtain booking URL, button or embed (online_booking_setup, write, asks 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.
Create and attach optional or required booking add-ons (manage_booking_add_ons, write, asks 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.
Add or edit booking-site announcement banner and location section, and arrange services (customize_booking_site_content, write, asks 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.
Manage booking branding, team profiles, business links, categories and image display (manage_booking_site_branding_and_service_display, write, asks 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.
Add or remove booking customer profile fields (manage_booking_customer_profile_fields, write, asks 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'.
View customer profile fields on appointments, classes and the customer profile (view_booking_customer_profile_fields, 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.
Set booking timezone, Any Available staff, multiple services and staff-name visibility (booking_timezone_and_staff_choice_settings, write, asks 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.
Disable the online booking site (disable_online_booking, write, asks first): Disable the online booking site. Desktop Online Booking > Channels > Enable online booking OFF > Confirm.
Create, edit, copy embed code for and delete advanced booking widgets (manage_advanced_booking_widgets, write, asks 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.
Compose and send online-booking invitation campaigns (send_booking_invitations, write, asks 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.
Request activation or deactivate Reserve with Google (manage_reserve_with_google, write, asks 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.
Connect, test or delete a Facebook Book Now button (manage_facebook_booking_button, write, asks 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.
Review/edit Square Go listing and activate or opt out locations (manage_square_go_listing, write, asks 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.

Appointments settings > Communications (Square Assistant)

Enable, disable and manage Square Assistant (automated SMS confirm/cancel/reschedule replies).

Enable, disable and manage Square Assistant (automated SMS confirm/cancel/reschedule replies) (square_assistant_settings, write, asks 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.

Messages

Read appointment-related client conversations in Messages. Send appointment-related text and email messages to customers.

Read appointment-related client conversations in Messages (messages_inbox_read, 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.
Send appointment-related text and email messages to customers (messages_send_to_customers, write, asks 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.

Calendar management

Link a Google Calendar to the appointments calendar (import and export, import only, or export only). Refresh or remove a synced Google Calendar.

Link a Google Calendar to the appointments calendar (import and export, import only, or export only) (link_google_calendar, write, asks 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.
Refresh or remove a synced Google Calendar (refresh_or_remove_synced_calendar, write, asks 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.
Create a personal calendar event, optionally blocking time or recurring (create_personal_event, write, asks 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.
Set calendar view attributes and display filters (set_calendar_view_filters, 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.
Export appointment history as CSV (export_appointment_history, read): Export appointment history as CSV. Desktop Appointments > Settings > History > Export; download/save CSV.

Payments

Charge or record payment for an appointment or class attendee. Configure prepayment, cancellation and no-show fee policies.

Charge or record payment for an appointment or class attendee (take_appointment_or_class_payment, write, asks 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.
Configure prepayment, cancellation and no-show fee policies (manage_booking_payment_and_cancellation_policies, write, asks 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.
Enforce cancellation policy during eligible cancellation or modification handling (enforce_cancellation_fee, write, asks 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.
Require fixed or percentage appointment deposits (configure_appointment_deposits, write, asks 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.
Refund an appointment deposit during cancellation or through Transactions (refund_appointment_deposit, write, asks 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.

Customer management

Update booking customer timezone and appointment notification preference.

Update booking customer timezone and appointment notification preference (manage_customer_booking_contact_preferences, write, asks 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.

Packages

View package definitions and purchased-package balances. Create, edit permitted package attributes and delete package offerings.

View package definitions and purchased-package balances (read_package_catalog_and_customer_balances, 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.
Create, edit permitted package attributes and delete package offerings (manage_package_definitions, write, asks 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.
Sell and charge for a package through Directory or Virtual Terminal (sell_package_desktop, write, asks 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.
Enable package website sales and obtain location-specific payment links (publish_package_sales_channels, write, asks 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.
Apply package credit and record appointment/class payment (redeem_package_desktop, write, asks 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.
Refund an entire package purchase or a specified amount (refund_package_purchase, write, asks 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.
Remove a package-paid class attendee and select package refund method (remove_package_paid_class_attendee, write, asks 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.

Inputs, REST path and example response of every tool: https://cotlet.dev/integrations/square-appointments-api-mcp-server#tools

Who can see my Square Appointments session, and how do I revoke it?

What we store. Your signed-in Square Appointments profile, AES-256-GCM encrypted, in Finland. No password.
What your agent gets. The 68 Square Appointments tools for the work described on this page.
What the session sees. The records and screens available to your signed-in role in Square Appointments.
What no tool touches. Owner password, sign-in email, account profile, MFA, Square subscription billing and bank credentials. New Google or social-account authorizations stay with you.
If Square Appointments signs you out. You sign in again yourself, in the same Cloud Browser.
How to cut access. Disable for agents, reset the browser, or change your Square Appointments password.

Cotlet never sees or stores your password. You sign in yourself in your Cloud Browser. Our site scores A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory (live results).

What happens when Square Appointments changes?

Cotlet watches Square Appointments and updates the server when its screens change.

New Square Appointments features become available to the agent within your account permissions.

Your Square Appointments account and role determine which records and screens the agent can use.

If Square Appointments signs you out, open your Cloud Browser with one click from the Cotlet console and sign in again.

Approvals, undo and mistakes

Choose the salon location and day. Review the appointment book for the location, staff and dates you name.
Read the pending work. Open pending appointment requests and the waitlist details beside the available times.
Prepare the selected appointment. Keep the client, service, staff member, duration and notification together before you approve the change.
Review the resulting calendar. Check that the selected appointment appears in the staff calendar at the agreed time.

Action	Undo
Create and schedule appointments (specific time, all day, or recurring)	Review the operation and its current record before choosing a corrective action.

Calls marked Asks first wait for your approval by default. You can turn this off for each tool. Unmarked tools run at once.

MCP call:

{
  "name": "messages_inbox_read",
  "arguments": {}
}

REST:

curl https://cotlet.dev/api/v1/square-appointments/inbox-reads/messages \
  -H "Authorization: Bearer $COTLET_API_KEY"

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"
}

A cron job or n8n flow can call the same tools over REST at /api/v1/square-appointments with the same key and price, in JSON. Failed calls are free. Each tool row above shows its REST path.

How much does the Square Appointments MCP server cost?

About $20 a month for a salon owner reviewing three staff calendars and forty appointments each week, 3,460 credits. Your Square Appointments plan stays as it is.

Job	Calls	Credits
View upcoming appointments for selected staff members on the calendar	1 × 60	600
View the waitlist and open an entry's details	1 × 32	320
View and edit documented past appointment details	1 × 40	400
Create and schedule appointments (specific time, all day, or recurring)	1 × 40	400
Send appointment-related text and email messages to customers	1 × 24	240
Cloud Browser, 30 days		1,500
Total		3,460

The $29 pack covers a typical month for most owners.

Free 7-day trial, no card
10 credits per successful call, MCP or REST
50 credits a day for the Cloud Browser
Use the features included in your existing Square Appointments plan.

Assumed successful calls for this owner workload. Dollars use the $29 pack rate.

Square Appointments MCP server: connection options

Option	What it does	Where it stops
Square Bookings API	Public API for availability and booking operations.	Seller-level booking writes require Plus or Premium; buyer-level writes have a different scope.
Official Square MCP	Square publishes a remote MCP connection with account authorization.	The reviewed vendor sources do not establish its current Appointments tool coverage.
Square Assistant	Automated appointment replies by text for supported confirmation and schedule changes.	Its supported appointment conversation flow differs from reviewing the full staff calendar.
Manual calendar work	Review staff calendars, pending requests and the waitlist directly.	You perform the reviews, changes and messages yourself.

Among these options, Cotlet lets your AI agent read and write on every Square Appointments screen your account can use, from ChatGPT, Claude or any MCP client, without a Square API key and on your current Square plan.

Who runs Cotlet

Take Group sp. z o.o. runs Cotlet. It is a software company registered in Poland, EU (VAT PL6342984273), in business since 2019, led by its founders Bart Krawczyk (Co-founder, CTO) and Jake Slugocki (Co-founder, SEO, sales and marketing). Questions about the Square Appointments tools go to contact@cotlet.dev.

Square Appointments MCP server: questions

How do I get access?

Create a Cotlet account, open Square Appointments and sign in at squareup.com/login. Enable it for agents, then add Cotlet to your chosen AI assistant.

How do I connect Square Appointments to ChatGPT or Claude?

Sign up at cotlet.dev, log in to Square Appointments once in its Cloud Browser and add Cotlet to ChatGPT or Claude, following the steps in your console. No API key is needed. ChatGPT and Claude then work in your Square Appointments account through Cotlet, in their phone apps too.

What can ChatGPT do in Square Appointments?

With Cotlet, ChatGPT, Claude and other AI agents handle jobs like these in Square Appointments: prepare tomorrow's appointment book; fill a suitable cancellation slot; prepare the right service and staff. You ask in plain words, and anything that reaches other people waits for your OK first.

Is there an official ChatGPT or Claude app for Square Appointments?

Square provides an official MCP server. Its current Appointments tool coverage was not established in the vendor sources reviewed; the separately announced AI ordering integrations concern food and beverage orders. Cotlet is independent and is not affiliated with Square Appointments.

Can ChatGPT schedule an appointment in Square Appointments?

Provide the client, service, staff member, location and preferred time. Your agent reviews the calendar and prepares the appointment, including its duration and any client notification, for your approval.

Can ChatGPT review the Square Appointments waitlist?

Choose the location and opening you want to fill. Your agent reads the waitlist request details and prepares a message for a client whose preferences fit the slot.

Can ChatGPT accept a pending Square appointment?

Identify the request and staff member. Your agent checks the requested time and prepares acceptance or rejection with the exact client message before you approve it.

Can ChatGPT change staff availability in Square Appointments?

Specify the staff member, dates and hours. Your agent prepares a one-time or recurring availability change and shows the affected calendar before applying it.

Can ChatGPT schedule a class in Square Appointments?

Provide the class, location, instructor, date, time and capacity. Your agent prepares the supported class schedule in your account; your current plan and permissions determine availability.

Does Square Appointments have an API?

Square publishes a Bookings API. Buyer-level booking writes are available on Free; seller-level creation, updates and cancellation require Appointments Plus or Premium and the corresponding API permissions.

Is the MCP server different from the REST API?

Only in how it is called. Both carry the same 68 tools, inputs, answers, API key and price. Agents use MCP; scripts and HTTP steps use REST.

Is Cotlet affiliated with Square Appointments?

No. Cotlet is independent and not affiliated with Square Appointments.

Give your AI agents your signed-in browser.

Product: Integrations · How it works · Pricing · Security

Resources: Blog · API docs · Help center · Changelog · GitHub

Solutions: For developers · For automation agencies

Company: About · AI info: company facts · Contact

Legal: Terms of service · Privacy policy · Refund policy · Acceptable use · Cookie policy · DPA · Subprocessors

Elsewhere: Status page · Cotlet on GitHub · Cotlet on X · Cotlet on LinkedIn · Cotlet on Product Hunt · Cotlet on Crunchbase · Cotlet on SaaSHub

Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. About us

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.