Salonized API and MCP server Let your AI agent run your Salonized calendar.

ToolWhat it doesAccess

• list_appointments List calendar appointments in a date range, with customer, services, employee and time. read

  Returns each appointment with its ID, start time, customer, services with price, employee and whether it is marked as a no-show, ordered by start time. Absences and breaks are not appointments and are left out. Locations follow the location you work in.

  MCP callsalonized_read → list_appointments

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

  Parameters

  Parameters: list_appointments

  Name	Type	Description
  from string required	string	First day, YYYY-MM-DD.
  to string required	string	Last day, YYYY-MM-DD.
  employee string	string	Employee name, as shown in the calendar. Omit for everyone.

  Example input

  {
    "from": "from",
    "to": "to"
  }

  Example response

  {
    "appointments": [
      {
        "appointment_id": "48213907",
        "start": "2026-11-05T10:00",
        "customer": {
          "customer_id": "9120345",
          "name": "Sanne de Vries"
        },
        "services": [
          {
            "name": "Cut and finish",
            "price": 45
          }
        ],
        "employee": "Eva Bakker",
        "no_show": false
      }
    ]
  }

• get_appointment Read one appointment with its note and total. read

  Returns the services in order, the employee, the appointment total and the appointment note, which the customer does not see. Use it to read the colour formula left on the last visit.

  MCP callsalonized_read → get_appointment

  REST endpointGET https://cotlet.dev/api/v1/salonized/appointments/{appointment_id}

  Parameters

  Parameters: get_appointment

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

  Example input

  {
    "appointment_id": "appointment_8c41d2"
  }

  Example response

  {
    "appointment_id": "48213907",
    "start": "2026-11-05T10:00",
    "customer": {
      "customer_id": "9120345",
      "name": "Sanne de Vries"
    },
    "services": [
      {
        "name": "Cut and finish",
        "price": 45
      }
    ],
    "employee": "Eva Bakker",
    "note": "Toner 8.1, 20 minutes",
    "total": 45,
    "no_show": false
  }

• list_services List the services of the salon with their price. read

  Returns each service as the appointment form lists it, with its name and price. The agent uses the names when it books. Services you cannot see in the form are not returned.

  MCP callsalonized_read → list_services

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

  Parameters

  No parameters.

  Example response

  {
    "services": [
      {
        "name": "Cut and finish",
        "price": 45
      },
      {
        "name": "Colour",
        "price": 65
      }
    ]
  }

• create_appointment Add an appointment to the calendar for a customer. writeasks first

  Creates the appointment as the calendar form does and returns its ID and total. Salonized does not stop an overlap, so the agent checks list_appointments first. With send_email_notifications on, the customer gets the confirmation email. By default you confirm each call; you can switch that off for this tool.

  MCP callsalonized_write → create_appointment

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

  Parameters

  Parameters: create_appointment

  Name	Type	Description
  customer_id string required	string	Customer ID from find_customer.
  services string[] required	string[]	Service names from list_services, in the order they are done.
  start string required	string	Start time, YYYY-MM-DDTHH:MM.
  employee string	string	Employee name. Required when the salon has more than one.
  note string	string	Appointment note. The customer does not see it.
  send_email_notifications boolean	boolean	Mirrors the Send email notifications box of the appointment form. False by default: the customer gets no confirmation.

  Example input

  {
    "customer_id": "9120345",
    "services": [
      "Cut and finish"
    ],
    "start": "2026-11-05T10:00",
    "employee": "Eva Bakker",
    "send_email_notifications": false
  }

  Example response

  {
    "appointment_id": "48213907",
    "start": "2026-11-05T10:00",
    "customer_id": "9120345",
    "services": [
      {
        "name": "Cut and finish",
        "price": 45
      }
    ],
    "employee": "Eva Bakker",
    "total": 45,
    "email_sent": false
  }

• mark_no_show Mark an appointment as a no-show. writeasks first

  Ticks no-show on the appointment, as the Edit button does. The appointment shows a cross in the calendar and the customer profile counts it. If you set up the automatic email after a no-show in Salonized, that email goes out. By default you confirm each call; you can switch that off for this tool.

  MCP callsalonized_write → mark_no_show

  REST endpointPOST https://cotlet.dev/api/v1/salonized/appointments/{appointment_id}/no-show/mark

  Parameters

  Parameters: mark_no_show

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

  Example input

  {
    "appointment_id": "appointment_8c41d2"
  }

  Example response

  {
    "appointment_id": "48213907",
    "no_show": true,
    "customer_no_shows": 1
  }

ToolWhat it doesAccess

• find_customer Search the customer file by name, email or mobile number. read

  Returns matching customers with contact details and the number of no-shows. With several matches it returns all of them, so the agent asks which one you mean. Archived customers are not searched.

  MCP callsalonized_read → find_customer

  REST endpointGET https://cotlet.dev/api/v1/salonized/customers/find

  Parameters

  Parameters: find_customer

  Name	Type	Description
  query string required	string	Part of the name, email address or mobile number.

  Example input

  {
    "query": "query"
  }

  Example response

  {
    "customers": [
      {
        "customer_id": "9120345",
        "name": "Sanne de Vries",
        "email": "sanne@example.com",
        "mobile": "+31 6 12345678",
        "no_shows": 0
      }
    ]
  }

• get_customer Read a customer profile with notes and recent appointments. read

  Returns the notes on the profile with their follow-up dates and whether each is checked off, the appointments listed on the Appointments tab and the no-show count. Notes with a follow-up date also show in the calendar.

  MCP callsalonized_read → get_customer

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

  Parameters

  Parameters: get_customer

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

  Example input

  {
    "customer_id": "customer_8c41d2"
  }

  Example response

  {
    "customer_id": "9120345",
    "name": "Sanne de Vries",
    "notes": [
      {
        "text": "Colour 7.3, 6% developer, 35 minutes",
        "follow_up": "2026-12-17",
        "done": false
      }
    ],
    "no_shows": 0,
    "appointments": [
      {
        "appointment_id": "48213907",
        "start": "2026-11-05T10:00",
        "services": [
          "Cut and finish"
        ]
      }
    ]
  }

• add_customer Create a customer profile. write

  Creates the profile with first and last name, the only required fields in Salonized. The call sends nothing to the customer and can be undone by archiving the customer, so it does not ask first. The agent searches with find_customer before it adds anyone.

  MCP callsalonized_write → add_customer

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

  Parameters

  Parameters: add_customer

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

  Example input

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

  Example response

  {
    "customer_id": "9120377",
    "name": "Lotte Smit",
    "email": "lotte@example.com"
  }

• add_customer_note Add a note to a customer profile, with an optional follow-up date. write

  Adds one more note; earlier notes stay. A note with a follow-up date appears in the calendar. Nobody is contacted, and the note can be deleted in the profile, so it does not ask first.

  MCP callsalonized_write → add_customer_note

  REST endpointPOST https://cotlet.dev/api/v1/salonized/customers/{customer_id}/note

  Parameters

  Parameters: add_customer_note

  Name	Type	Description
  customer_id string required	string	Customer ID from find_customer.
  text string required	string	The note.
  follow_up string	string	Follow-up date, YYYY-MM-DD. The note then shows in the calendar until checked off.

  Example input

  {
    "customer_id": "customer_8c41d2",
    "text": "text"
  }

  Example response

  {
    "customer_id": "9120345",
    "note_id": "7731",
    "text": "Colour 7.3, 6% developer, 35 minutes",
    "follow_up": "2026-12-17"
  }

ToolWhat it doesAccess

• list_waiting_list List waiting list sign-ups for a day. read

  Returns each sign-up with the customer, services, staff preference, time frame (morning, afternoon or evening) and note. Needs the waiting list switched on, which is part of the Basic and Pro plans.

  MCP callsalonized_read → list_waiting_list

  REST endpointGET https://cotlet.dev/api/v1/salonized/waiting-lists

  Parameters

  Parameters: list_waiting_list

  Name	Type	Description
  date string required	string	Day, YYYY-MM-DD.

  Example input

  {
    "date": "date"
  }

  Example response

  {
    "date": "2026-11-05",
    "signups": [
      {
        "customer": "Mark Jansen",
        "services": [
          "Cut and finish"
        ],
        "staff_preference": "Eva Bakker",
        "timeframe": "afternoon",
        "note": "Any time after 15:00"
      }
    ]
  }

• add_to_waiting_list Add a customer to the waiting list for a day. write

  Adds the entry the Waiting List page shows under New Registration. The customer is not contacted by this call, and you can remove the entry in Salonized, so it does not ask first. Needs the waiting list switched on.

  MCP callsalonized_write → add_to_waiting_list

  REST endpointPOST https://cotlet.dev/api/v1/salonized/customers/{customer_id}/waiting-lists

  Parameters

  Parameters: add_to_waiting_list

  Name	Type	Description
  customer_id string required	string	Customer ID from find_customer.
  services string[] required	string[]	Service names from list_services.
  date string required	string	Day, YYYY-MM-DD.
  employee string	string	Staff preference.
  timeframe string	string	morning, afternoon or evening.
  note string	string	Note, visible to staff only.

  Example input

  {
    "customer_id": "customer_8c41d2",
    "services": [
      "services"
    ],
    "date": "date"
  }

  Example response

  {
    "customer_id": "9120377",
    "date": "2026-11-05",
    "services": [
      "Cut and finish"
    ],
    "timeframe": "afternoon"
  }

• get_sales_report Read the Totals report of the Reports page for a period. read

  Returns total revenue with and without VAT, split into products and services, gift card sales, discounts given, payment methods, the number of invoices and appointments and the number of new customers. Needs the Basic plan or higher. Daily totals can differ from the day view.

  MCP callsalonized_read → get_sales_report

  REST endpointGET https://cotlet.dev/api/v1/salonized/sales-report

  Parameters

  Parameters: get_sales_report

  Name	Type	Description
  from string required	string	First day, YYYY-MM-DD.
  to string required	string	Last day, YYYY-MM-DD.

  Example input

  {
    "from": "from",
    "to": "to"
  }

  Example response

  {
    "from": "2026-10-26",
    "to": "2026-11-01",
    "revenue_incl_vat": 3025,
    "revenue_excl_vat": 2500,
    "services": 2200,
    "products": 300,
    "invoices": 58,
    "appointments": 62,
    "new_customers": 7
  }