Book Mangomint appointments from client texts with an AI agent

1. Click an empty spot on the Mangomint calendar, or tap and hold in the mobile app, to open the appointment details on the right.
2. Select the client and the service, and select Add Service for each extra service.
3. Drag the appointment to another time or staff member if the first slot clashes, then select Book Appointment.
4. To let the client finish the booking, turn on Use Express Booking with only first name, phone and service, and select Send Text Message so the client completes the booking and any card or deposit.
5. Requests pile up overnight by text, DM and email, and each one is a client lookup, a slot search and a booking done by hand the next morning.

Jamie texted asking for a signature facial with Alex next Friday afternoon. Find her, check Alex's day and book the first free slot after 1pm.

1. 01

   Match the sender to a client

   The agent searches find_client by the phone number or email the message came from first, and by name only if that fails. Two or more matches stop the run with a question; a client is never guessed.

2. 02

   Read notes before booking

   Client notes and tags come back with the match. An allergy or a "deposit required" note is shown to you with the proposed booking.

3. 03

   Turn the words into a service

   The agent maps "facial" or "brows" to the menu from list_services and checks that the requested stylist performs it. A loose word that fits several services becomes a short question.

4. 04

   Find the slot

   It reads the stylist's day with list_appointments and picks the first gap long enough for every service in the request, inside the window the client asked for, plus one fallback time.

5. 05

   Book with a note

   After your OK it calls book_appointment and puts the original request in the appointment note, so the front desk sees where the booking came from.

Request: "facial with Alex Friday afternoon?" from +1 503 555 0142
Client: Jamie Doe, VIP. Note: prefers fragrance-free products
Alex, Fri 16 Oct: free 2:00 to 3:30 PM and 4:30 to 6:00 PM
Booked: Signature Facial, Fri 16 Oct 2:00 to 3:00 PM with Alex (ap_903114)
Fallback offered: 4:30 PM, not used

• A booking made by staff sends the client Mangomint's Appointment Booked email and text only when Send for appointments booked by a staff member is on, under Settings > Automated Messages > Appointment Booked.
• Mangomint sets each new appointment to Unconfirmed or Confirmed by an account setting, and an appointment booked after the confirmation request would have gone out is set to Confirmed automatically.
• A client-specific service duration saved on the client's Adjustments tab applies automatically to calendar bookings, so the booked end time can differ from the service menu.
• An Express Booking the client does not complete within the time limit is canceled automatically with a text to the client, and it is deleted from the Mangomint calendar after 24 hours.

book_appointment asks for your OK by default. To run it on a schedule without you, switch confirmation off for that tool in your dashboard.

Sources: Mangomint: Create an Appointment · Mangomint: Automated Messages, Appointment Booked · Mangomint: Client-Specific Service Durations · Mangomint: Using Express Booking

curl https://cotlet.dev/api/v1/mangomint/book_appointment \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"client_id":"cl_48213","location_id":"loc_1","service_ids":["svc_signature_facial"],"staff_id":"st_207","start":"2026-10-16T14:00:00-07:00","note":"Booked from client text: facial with Alex Friday afternoon"}'

{
  "appointment_id": "ap_903114",
  "status": "booked",
  "client": {
    "client_id": "cl_48213",
    "name": "Jamie Doe"
  },
  "services": [
    {
      "service_id": "svc_signature_facial",
      "name": "Signature Facial",
      "duration_minutes": 60
    }
  ],
  "staff": {
    "staff_id": "st_207",
    "name": "Alex"
  },
  "start": "2026-10-16T14:00:00-07:00",
  "end": "2026-10-16T15:00:00-07:00"
}

MCP: add https://cotlet.dev/mcp/v1 with the same key; the tool is mangomint_book_appointment. Example data.

• Reschedule Mangomint appointments when staff is out
• Book clients from the Mangomint Intelligent Waitlist
• Get a weekly Mangomint sales and cancellations report
• Mangomint API and MCP server: every tool
• All use cases