Appointy MCP server Let your AI agent handle Appointy bookings.

ToolWhat it doesAccess

• list_appointments Appointments for a day or range, by staff member or service. read

  Returns appointments with customer, service, staff member, start time, status and payment status.

  MCP callappointy_read → list_appointments

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

  Parameters

  Parameters: list_appointments

  Name	Type	Description
  date_from string required	string	ISO date.
  date_to string	string	ISO date. Default: date_from.
  staff string	string	Staff member name.
  status string	string	pending, confirmed or cancelled.
  page integer	integer	Page number. Default: 1.

  Example input

  {
    "date_from": "date from"
  }

  Example response

  {
    "appointments": [
      {
        "appointment_id": "AP-662019",
        "customer": "Olivia Grant",
        "service": "60 min massage",
        "staff": "Rachel",
        "start": "2026-11-12T15:00",
        "status": "Confirmed"
      }
    ],
    "page": 1
  }

• find_free_slots Open times for a service on a day. read

  Returns start times where the service fits, per staff member, using your working hours and existing bookings.

  MCP callappointy_read → find_free_slots

  REST endpointGET https://cotlet.dev/api/v1/appointy/free-slots/find

  Parameters

  Parameters: find_free_slots

  Name	Type	Description
  service string required	string	Service name.
  date string required	string	ISO date.
  staff string	string	Staff member name.

  Example input

  {
    "service": "service",
    "date": "date"
  }

  Example response

  {
    "service": "60 min massage",
    "slots": [
      {
        "staff": "Rachel",
        "start": "2026-11-13T10:00"
      },
      {
        "staff": "Tom",
        "start": "2026-11-13T13:30"
      }
    ]
  }

• book_appointment Books a service for a customer with a staff member. writeasks first

  Creates the appointment. Your Appointy notification settings decide whether the customer gets a confirmation and reminders. By default you confirm each call; you can switch that off for this tool.

  MCP callappointy_write → book_appointment

  REST endpointPOST https://cotlet.dev/api/v1/appointy/customers/{customer_id}/appointments

  Parameters

  Parameters: book_appointment

  Name	Type	Description
  customer_id string required	string	Customer ID from list_customers.
  service string required	string	Service name.
  staff string required	string	Staff member name.
  start string required	string	ISO date and time from find_free_slots.
  note string	string	Booking note.

  Example input

  {
    "customer_id": "CU-31890",
    "service": "60 min massage",
    "staff": "Rachel",
    "start": "2026-11-13T10:00"
  }

  Example response

  {
    "appointment_id": "AP-662140",
    "customer": "Olivia Grant",
    "service": "60 min massage",
    "staff": "Rachel",
    "start": "2026-11-13T10:00",
    "status": "Confirmed"
  }

• approve_appointment Confirms a booking request that waits for approval. writeasks first

  Confirms a pending appointment when your booking page asks for approval. The customer gets your confirmation message. By default you confirm each call; you can switch that off for this tool.

  MCP callappointy_write → approve_appointment

  REST endpointPOST https://cotlet.dev/api/v1/appointy/appointments/{appointment_id}/approve

  Parameters

  Parameters: approve_appointment

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

  Example input

  {
    "appointment_id": "appointment_8c41d2"
  }

  Example response

  {
    "appointment_id": "AP-662201",
    "status": "Confirmed"
  }

• reschedule_appointment Moves an appointment to a new time or staff member. writeasks first

  Moves the appointment. Your notification settings decide whether the customer hears about it. By default you confirm each call; you can switch that off for this tool.

  MCP callappointy_write → reschedule_appointment

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

  Parameters

  Parameters: reschedule_appointment

  Name	Type	Description
  appointment_id string required	string	Appointment ID from list_appointments.
  start string required	string	New ISO date and time.
  staff string	string	New staff member. Default: unchanged.

  Example input

  {
    "appointment_id": "appointment_8c41d2",
    "start": "start"
  }

  Example response

  {
    "appointment_id": "AP-662019",
    "start": "2026-11-14T11:00",
    "staff": "Tom",
    "status": "Confirmed"
  }

• cancel_appointment Cancels an appointment. writeasks first

  Cancels the appointment and frees the slot. Refunds, if any, stay in Appointy. By default you confirm each call; you can switch that off for this tool.

  MCP callappointy_write → cancel_appointment

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

  Parameters

  Parameters: cancel_appointment

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

  Example input

  {
    "appointment_id": "appointment_8c41d2"
  }

  Example response

  {
    "appointment_id": "AP-662019",
    "status": "Cancelled"
  }

ToolWhat it doesAccess

• list_customers Customers, searchable by name, email or phone. read

  Returns customers with ID, contact details and the number of bookings.

  MCP callappointy_read → list_customers

  REST endpointGET https://cotlet.dev/api/v1/appointy/customers

  Parameters

  Parameters: list_customers

  Name	Type	Description
  query string	string	Name, email or phone.
  page integer	integer	Page number. Default: 1.

  Example response

  {
    "customers": [
      {
        "customer_id": "CU-31890",
        "name": "Olivia Grant",
        "email": "olivia@example.com",
        "phone": "555-0118",
        "bookings": 7
      }
    ],
    "page": 1
  }

• get_customer One customer with past and upcoming appointments. read

  Returns contact details, notes, past appointments with service and staff, and upcoming bookings.

  MCP callappointy_read → get_customer

  REST endpointGET https://cotlet.dev/api/v1/appointy/customers/{customer_id}

  Parameters

  Parameters: get_customer

  Name	Type	Description
  customer_id string required	string	Customer ID from list_customers.

  Example input

  {
    "customer_id": "customer_8c41d2"
  }

  Example response

  {
    "customer_id": "CU-31890",
    "name": "Olivia Grant",
    "past": [
      {
        "service": "60 min massage",
        "staff": "Rachel",
        "date": "2026-10-15"
      }
    ],
    "upcoming": [
      {
        "appointment_id": "AP-662019",
        "start": "2026-11-12T15:00"
      }
    ]
  }

• create_customer Adds a customer. write

  Creates the customer. Search list_customers first so a returning customer does not become a duplicate. Reaches no one, so it runs at once.

  MCP callappointy_write → create_customer

  REST endpointPOST https://cotlet.dev/api/v1/appointy/customers

  Parameters

  Parameters: create_customer

  Name	Type	Description
  name string required	string	Full name.
  email string	string	Email.
  phone string	string	Phone number.

  Example input

  {
    "name": "Jane Doe"
  }

  Example response

  {
    "customer_id": "CU-32004",
    "name": "Ben Carter",
    "email": "ben@example.com"
  }