Integrates with Square Appointments to review staff calendars, schedule and prepare bookings, inspect booking rules, manage staff availability, bookable resources and services, and cancel or mark appointments as no-show with confirmation.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Square Appointments MCP server Review tomorrow's appointments for all staff and flag any conflicts"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Connect Square Appointments to ChatGPT, Claude, Codex and Claude Code through Cotlet.dev. Review your salon calendar, prepare bookings and manage service availability in your signed-in Square Appointments account.
This is an unofficial integration, not affiliated with Square Appointments. Cotlet.dev hosts the connection through your Cloud Browser; this repository provides an optional Python stdio MCP bridge.
Open Square Appointments in your Cotlet.dev Cloud Browser, sign in yourself and enable it for agents.
Add Cotlet.dev to your agent using the connection details below.
Open Settings > Apps & Connectors > Create. Use https://cotlet.dev/mcp/v1/connect as the MCP server URL and choose OAuth.
Open Settings > Connectors > Add custom connector and enter https://cotlet.dev/mcp/v1/connect.
Create a Cotlet.dev API key in your console and set COTLET_API_KEY in your environment. Add this to your Codex configuration:
[mcp_servers.cotlet]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY"claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 --header "Authorization: Bearer $COTLET_API_KEY"Related MCP server: trinks-mcp-server
Examples based on the live Square Appointments integration reference:
Review upcoming appointments for selected staff members.
Prepare a proposed appointment with the customer, service, location and time for approval.
Review appointment intervals, advance booking limits and daily booking limits.
Update staff availability after approving the change to public booking slots.
Manage bookable services and resources with the required Square permissions.
Cancel or mark an appointment as no-show after confirming the client notification choice.
Representative operations from the live reference:
view_staff_calendars
schedule_appointment
appointment_booking_rules
update_staff_availability
manage_bookable_resources
create_manage_services
cancel_or_no_show_appointment
The live page describes 68 Cloud Browser capabilities, including 7 read and 61 write capabilities. Hosted operation groups use square_appointments_read and square_appointments_write. Square has an official MCP server; check its documented Appointments coverage for your task. Seller-level Bookings API writes require Square Appointments Plus or Premium. Browser actions depend on the signed-in user's Square plan and permissions.
Creating a booking can send a text or email notification. Confirm bookings, public availability changes, messages, cancellations and payments before execution.
Python 3.10 or newer is required, with no runtime dependencies. Clone this repository and configure a client that supports stdio:
{"mcpServers":{"square-appointments":{"command":"python3","args":["/absolute/path/to/square-appointments-mcp/square_appointments_agent.py"],"env":{"COTLET_API_KEY":"your-cotlet-key"}}}}The bridge lists seven browser helpers: square_appointments_guide, square_appointments_status, square_appointments_open, square_appointments_read, square_appointments_click, square_appointments_type and square_appointments_close. These forward to Cotlet.dev's shared browser tools. They are separate from the hosted Square Appointments capabilities above. Call the guide first and close the browser when finished. Tool discovery works without a key; executing a tool requires your Cotlet.dev key and connected account.
python3 square_appointments_agent.py connect
python3 square_appointments_agent.py guide
python3 square_appointments_agent.py status
python3 square_appointments_agent.py serveYou can also build the included Dockerfile and run it with COTLET_API_KEY supplied as an environment variable.
Licensed under Elastic License 2.0. See LICENSE.
Click a numbered element on the current Square Appointments page.
Inputs: element (required).
Close the Square Appointments browser session when the work is done, so credits stop running.
Inputs: no named parameters.
How to work in Square Appointments (appointments, staff calendars, services and booking requests): its screens and the sign-in link. Call this first.
Inputs: task.
Open a Square Appointments page in your signed-in Cloud Browser (default https://squareup.com/login) to work with appointments, staff calendars, services and booking requests.
Inputs: url.
Read the current Square Appointments page: its text and numbered buttons, links and fields.
Inputs: element.
Check that your Cotlet.dev account and Square Appointments are ready: account, credits and Square Appointments connection.
Inputs: no named parameters.
Type text into a numbered field on the current Square Appointments page.
Inputs: text (required), element (required).
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 7 tools
Each tool maps to a distinct phase of a browser session: orient (guide/status), open, observe (read), act (click/type), and tear down (close). The verbs are unambiguous and no two tools compete for the same action. Guide vs. status is the only near-neighbor, but one is documentation and the other is a readiness check, and the descriptions make that clear.
Every tool follows the same predictable pattern: a shared `square_appointments_` prefix plus a single action verb (guide, status, open, read, click, type, close). All snake_case, no camelCase or stylistic drift. This makes the set trivially scannable and groupable by action.
Seven tools is well within the sweet spot and each one earns its place by covering a necessary part of the browser-session lifecycle. There is no filler or redundancy; the surface is minimal but sufficient for iterating on a page.
The open → read → click/type → close loop covers the core interaction model for driving a web UI, and guide/status handle onboarding and readiness. Minor gaps exist around navigation helpers (explicit goto/back/scroll/wait or submit/keypress), which agents must work around by clicking links or typing into fields, but the main workflow is closed.
Scheduling, availability, clients, billing and CRM for appointment-based services.
Read appointments, types, calendars and availability; create, cancel or reschedule bookings.
Read Appointo bookings, availability and subscriptions; create, reschedule and cancel bookings.
Review appointments, customers and staff, and manage Bookafy bookings.