Planfy MCP server Let your AI agent run your Planfy bookings.

ToolWhat it doesAccess

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

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

  MCP callplanfy_read → list_appointments

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

  Example input

  {
    "date_from": "date from"
  }

  Example response

  {
    "appointments": [
      {
        "appointment_id": "PA-30122",
        "customer": "Eleanor Whitcombe",
        "service": "Cut and blow dry",
        "staff": "Gemma",
        "start": "2026-11-12T10:00",
        "status": "Confirmed"
      }
    ],
    "page": 1
  }

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

  Reads the staff calendars and returns start times where the service fits.

  MCP callplanfy_read → find_free_slots

  REST endpointGET https://cotlet.dev/api/v1/planfy/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.

  Example input

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

  Example response

  {
    "service": "Skin fade",
    "slots": [
      {
        "staff": "Tariq",
        "start": "2026-11-13T16:30"
      }
    ]
  }

• book_appointment Books a service for a customer. writeasks first

  Creates the appointment; Planfy sends its usual confirmation and SMS reminder by your settings. By default you confirm each call; you can switch that off for this tool.

  MCP callplanfy_write → book_appointment

  REST endpointPOST https://cotlet.dev/api/v1/planfy/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.
  start string required	string	ISO date and time.
  staff string	string	Staff member.

  Example input

  {
    "customer_id": "PC-4477",
    "service": "Skin fade",
    "start": "2026-11-13T16:30",
    "staff": "Tariq"
  }

  Example response

  {
    "appointment_id": "PA-30177",
    "customer": "Sophie Marlowe",
    "service": "Skin fade",
    "staff": "Tariq",
    "start": "2026-11-13T16:30",
    "status": "Confirmed"
  }

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

  Moves the appointment; your settings decide what the customer hears. By default you confirm each call; you can switch that off for this tool.

  MCP callplanfy_write → reschedule_appointment

  REST endpointPOST https://cotlet.dev/api/v1/planfy/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.

  Example input

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

  Example response

  {
    "appointment_id": "PA-30122",
    "start": "2026-11-14T11:00",
    "staff": "Gemma",
    "status": "Confirmed"
  }

ToolWhat it doesAccess

• list_recalls Customers due back by your recall rules. read

  Reads the Recalls tab: customers whose recall date has come, with last service.

  MCP callplanfy_read → list_recalls

  REST endpointGET https://cotlet.dev/api/v1/planfy/recalls

  Parameters

  Parameters: list_recalls

  Name	Type	Description
  due_by string	string	ISO date. Default: today.

  Example response

  {
    "recalls": [
      {
        "customer_id": "PC-4410",
        "customer": "Tariq Hussain",
        "last_service": "Eye test",
        "due": "2026-11-01"
      }
    ]
  }