Phorest MCP server Let your AI agent run the Phorest front desk.

ToolWhat it doesAccess

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

  Returns appointments with client, service, staff member, start time and status, in calendar order.

  MCP callphorest_read → list_appointments

  REST endpointGET https://cotlet.dev/api/v1/phorest/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.
  page integer	integer	Page number. Default: 1.

  Example input

  {
    "date_from": "date from"
  }

  Example response

  {
    "appointments": [
      {
        "appointment_id": "A-73120",
        "client": "Sophie Walsh",
        "service": "Full head colour",
        "staff": "Aoife",
        "start": "2026-11-12T10:00",
        "status": "Booked"
      }
    ],
    "page": 1
  }

• find_free_slots Open times for a service, optionally with one staff member. read

  Reads the calendar and returns start times where the service fits, per staff member who offers it.

  MCP callphorest_read → find_free_slots

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

  Parameters

  Parameters: find_free_slots

  Name	Type	Description
  service string required	string	Service name as in your menu.
  date string required	string	ISO date.
  staff string	string	Staff member name.

  Example input

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

  Example response

  {
    "service": "Cut and blow dry",
    "slots": [
      {
        "staff": "Aoife",
        "start": "2026-11-13T14:30"
      },
      {
        "staff": "Niamh",
        "start": "2026-11-13T16:00"
      }
    ]
  }

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

  Creates the appointment on the calendar. Your Phorest reminder settings decide whether the client gets a confirmation. By default you confirm each call; you can switch that off for this tool.

  MCP callphorest_write → book_appointment

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

  Parameters

  Parameters: book_appointment

  Name	Type	Description
  client_id string required	string	Client ID from list_clients.
  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	Appointment note.

  Example input

  {
    "client_id": "CL-40192",
    "service": "Cut and blow dry",
    "staff": "Aoife",
    "start": "2026-11-13T14:30"
  }

  Example response

  {
    "appointment_id": "A-73188",
    "client": "Sophie Walsh",
    "service": "Cut and blow dry",
    "staff": "Aoife",
    "start": "2026-11-13T14:30",
    "status": "Booked"
  }

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

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

  MCP callphorest_write → reschedule_appointment

  REST endpointPOST https://cotlet.dev/api/v1/phorest/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": "A-73120",
    "start": "2026-11-14T11:00",
    "staff": "Niamh",
    "status": "Booked"
  }

• cancel_appointment Cancels an appointment with a reason. writeasks first

  Marks the appointment cancelled and frees the slot. The reason is kept on the client record. By default you confirm each call; you can switch that off for this tool.

  MCP callphorest_write → cancel_appointment

  REST endpointPOST https://cotlet.dev/api/v1/phorest/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": "A-73120",
    "status": "Cancelled",
    "reason": "Client request"
  }

ToolWhat it doesAccess

• list_clients Clients, searchable by name, phone or email. read

  Returns clients with ID, contact details and last visit. Pass the client_id to get_client or book_appointment.

  MCP callphorest_read → list_clients

  REST endpointGET https://cotlet.dev/api/v1/phorest/clients

  Parameters

  Parameters: list_clients

  Name	Type	Description
  query string	string	Name, mobile or email.
  not_visited_days integer	integer	Only clients with no visit in this many days.
  page integer	integer	Page number. Default: 1.

  Example response

  {
    "clients": [
      {
        "client_id": "CL-40192",
        "name": "Sophie Walsh",
        "mobile": "+353 85 555 0142",
        "email": "sophie@example.com",
        "last_visit": "2026-09-30"
      }
    ],
    "page": 1
  }

• get_client One client with visit history, notes and upcoming bookings. read

  Returns the client record: contact details, notes, past services with staff and dates, and upcoming appointments.

  MCP callphorest_read → get_client

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

  Parameters

  Parameters: get_client

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

  Example input

  {
    "client_id": "client_8c41d2"
  }

  Example response

  {
    "client_id": "CL-40192",
    "name": "Sophie Walsh",
    "notes": "Colour formula 6.3 + 20 vol",
    "history": [
      {
        "service": "Full head colour",
        "staff": "Aoife",
        "date": "2026-09-30"
      }
    ],
    "upcoming": []
  }

• create_client Adds a new client. write

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

  MCP callphorest_write → create_client

  REST endpointPOST https://cotlet.dev/api/v1/phorest/clients

  Parameters

  Parameters: create_client

  Name	Type	Description
  first_name string required	string	First name.
  last_name string required	string	Last name.
  mobile string	string	Mobile number.
  email string	string	Email.

  Example input

  {
    "first_name": "first name",
    "last_name": "last name"
  }

  Example response

  {
    "client_id": "CL-40311",
    "name": "Emma Byrne",
    "mobile": "+353 87 555 0199"
  }

• add_client_note Adds a note to a client record. write

  Appends a note, for example a colour formula or a preference. Visible to your team only, so it runs at once.

  MCP callphorest_write → add_client_note

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

  Parameters

  Parameters: add_client_note

  Name	Type	Description
  client_id string required	string	Client ID from list_clients.
  note string required	string	Note text.

  Example input

  {
    "client_id": "client_8c41d2",
    "note": "note"
  }

  Example response

  {
    "client_id": "CL-40192",
    "note_added": "Prefers Saturday mornings"
  }

ToolWhat it doesAccess

• list_services Your service menu with durations and prices. read

  Returns services by category with duration and price, so the agent books the exact service name.

  MCP callphorest_read → list_services

  REST endpointGET https://cotlet.dev/api/v1/phorest/services

  Parameters

  Parameters: list_services

  Name	Type	Description
  category string	string	Service category.

  Example response

  {
    "services": [
      {
        "name": "Cut and blow dry",
        "category": "Hair",
        "duration_min": 60,
        "price": "55.00"
      }
    ]
  }