GlossGenius API and MCP server

• POST

  list_appointments

  Appointments in a date range with client, services, provider, deposit and confirmation.

  read

  Returns the appointments on your GlossGenius calendar in start order, past and future. Cancelled appointments are removed from the calendar, so they are not returned. Another team member's calendar needs the calendar permission for that person.

  POST /api/v1/glossgenius/list_appointments

  Input

  Input: list_appointments

  Parameter	Type	Description
  from required	date	First day, inclusive.
  to	date	Last day, inclusive. Default: same as from.
  provider_id	string	Team member ID from list_services. Default: you.

  Example response

  {
    "appointments": [
      {
        "appointment_id": "ap_771920",
        "start": "2026-10-12T11:00:00-04:00",
        "end": "2026-10-12T12:00:00-04:00",
        "client": {
          "client_id": "cl_50377",
          "name": "Jess T."
        },
        "services": [
          "Root Touch-up"
        ],
        "provider": "Sam",
        "deposit_required": false,
        "confirmed": true
      },
      {
        "appointment_id": "ap_771935",
        "start": "2026-10-13T14:00:00-04:00",
        "end": "2026-10-13T14:45:00-04:00",
        "client": {
          "client_id": "cl_48213",
          "name": "Maya R."
        },
        "services": [
          "Gel Manicure"
        ],
        "provider": "Sam",
        "deposit_required": true,
        "confirmed": false
      }
    ]
  }

• POST

  get_appointment

  Full appointment: services, duration, address, notes, deposit requirement and confirmation.

  read

  Returns one appointment with the fields GlossGenius lets you edit on it: provider, date and time, service duration, services, address, notes, deposit requirement and appointment confirmation. The price shown is the service price; adjustments are made at checkout.

  POST /api/v1/glossgenius/get_appointment

  Input

  Input: get_appointment

  Parameter	Type	Description
  appointment_id required	string	Appointment ID from list_appointments.

  Example response

  {
    "appointment_id": "ap_771935",
    "start": "2026-10-13T14:00:00-04:00",
    "end": "2026-10-13T14:45:00-04:00",
    "client": {
      "client_id": "cl_48213",
      "name": "Maya R."
    },
    "services": [
      {
        "name": "Gel Manicure",
        "duration_minutes": 45,
        "price": 55
      }
    ],
    "provider": "Sam",
    "address": "Studio, 12 Example St",
    "notes": "Prefers short nails.",
    "deposit_required": true,
    "confirmed": false
  }

• POST

  list_services

  Your service menu with duration, price, and the team members who offer each service.

  read

  Returns every service on your menu with its ID, duration and price, plus the team members who offer it. Use the IDs in find_open_slots and book_appointment. Team member IDs from here go into every provider_id parameter.

  POST /api/v1/glossgenius/list_services

  Input

  No parameters.

  Example response

  {
    "services": [
      {
        "service_id": "sv_1092",
        "name": "Gel Manicure",
        "duration_minutes": 60,
        "price": 55,
        "providers": [
          {
            "provider_id": "tm_207",
            "name": "Sam"
          }
        ]
      },
      {
        "service_id": "sv_1104",
        "name": "Root Touch-up",
        "duration_minutes": 60,
        "price": 85,
        "providers": [
          {
            "provider_id": "tm_207",
            "name": "Sam"
          },
          {
            "provider_id": "tm_311",
            "name": "Ria"
          }
        ]
      }
    ]
  }

• POST

  find_open_slots

  Open times for a service on your calendar, after working hours, personal blocks and gap time.

  read

  Returns start times in your working hours that are free for the combined length of the services, in start order. Appointments, personal time blocks and gap time are taken out. GlossGenius can still book outside these times, so this tool only suggests them.

  POST /api/v1/glossgenius/find_open_slots

  Input

  Input: find_open_slots

  Parameter	Type	Description
  service_ids required	string[]	One or more service IDs from list_services.
  from required	date	First day to search.
  to	date	Last day to search. Default: same as from.
  provider_id	string	Team member ID from list_services. Default: you.

  Example response

  {
    "slots": [
      {
        "start": "2026-10-15T15:30:00-04:00",
        "end": "2026-10-15T16:30:00-04:00",
        "provider_id": "tm_207"
      },
      {
        "start": "2026-10-15T16:30:00-04:00",
        "end": "2026-10-15T17:30:00-04:00",
        "provider_id": "tm_207"
      }
    ]
  }

• POST

  find_client

  Search clients by name, email or phone.

  read

  Returns matching client profiles with ID, name, email and phone. Client profiles are private to your business. A team member without client permission gets a permission error.

  POST /api/v1/glossgenius/find_client

  Input

  Input: find_client

  Parameter	Type	Description
  query required	string	Name, email or phone.

  Example response

  {
    "clients": [
      {
        "client_id": "cl_48213",
        "name": "Maya R.",
        "email": "maya@example.com",
        "phone": "+1 555 0100"
      }
    ]
  }

• POST

  get_client

  Client profile: contact details, birthday, notes and appointment history.

  read

  Returns the client profile with contact details, birthday, saved notes and past and upcoming appointments. Notes include the ones you added under Notes and Forms. Whether the client is banned from online booking is included.

  POST /api/v1/glossgenius/get_client

  Input

  Input: get_client

  Parameter	Type	Description
  client_id required	string	Client ID from find_client.

  Example response

  {
    "client_id": "cl_50377",
    "name": "Jess T.",
    "email": "jess@example.com",
    "phone": "+1 555 0101",
    "birthday": "1990-03-14",
    "banned_from_online_booking": false,
    "notes": [
      {
        "note_id": "nt_9001",
        "text": "Prefers a cooler tone.",
        "created": "2026-09-02"
      }
    ],
    "appointments": [
      {
        "appointment_id": "ap_771920",
        "start": "2026-10-12T11:00:00-04:00",
        "services": [
          "Root Touch-up"
        ]
      }
    ]
  }

• POST

  list_waitlist

  Active waitlist entries with client, service and the time they asked for.

  read

  Returns the active waitlist entries from the Calendar, in the order GlossGenius lists them, each with the client, service, requested time and note. Expired entries are not shown, because GlossGenius does not show them in the app. A client can join the waitlist for any day and time.

  POST /api/v1/glossgenius/list_waitlist

  Input

  Input: list_waitlist

  Parameter	Type	Description
  provider_id	string	Team member ID from list_services. Default: you.

  Example response

  {
    "entries": [
      {
        "entry_id": "wl_3302",
        "client": {
          "client_id": "cl_48213",
          "name": "Maya R."
        },
        "service": "Gel Manicure",
        "requested_start": "2026-10-16T14:00:00-04:00",
        "requested_end": "2026-10-16T17:00:00-04:00",
        "note": "Any time after 2pm works."
      },
      {
        "entry_id": "wl_3318",
        "client": {
          "client_id": "cl_50377",
          "name": "Jess T."
        },
        "service": "Root Touch-up",
        "requested_start": "2026-10-16T10:00:00-04:00",
        "requested_end": "2026-10-16T12:00:00-04:00",
        "note": ""
      }
    ]
  }

• POST

  get_sales_summary

  Sales Report totals: services, retail, gratuity, cash and check, taxes, refunds and card fees.

  read

  Returns the figures of the Sales Report for the period: service and retail sales, gratuity collected, cash and check amounts, taxes paid, refunds given and card transaction fees. It needs the View Reports permission. It returns nothing while the account is paused, cancelled or disabled.

  POST /api/v1/glossgenius/get_sales_summary

  Input

  Input: get_sales_summary

  Parameter	Type	Description
  from required	date	First day, inclusive.
  to required	date	Last day, inclusive.

  Example response

  {
    "from": "2026-10-05",
    "to": "2026-10-11",
    "services_sales": 4120,
    "retail_sales": 310,
    "total_sales": 4430,
    "gratuity": 655,
    "cash_and_check": 420,
    "taxes": 24.8,
    "refunds": 55,
    "card_fees": 128.45
  }

• POST

  book_appointment

  Book a client into a time on your calendar. GlossGenius notifies the client if you ask it to.

  asks first write

  Creates one appointment and returns its ID, time and services. GlossGenius allows booking any day and time, even outside working hours, so call find_open_slots first. It books one appointment, not a repeating series. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/glossgenius/book_appointment

  Input

  Input: book_appointment

  Parameter	Type	Description
  client_id required	string	Client ID from find_client.
  service_ids required	string[]	Service IDs from list_services.
  start required	datetime	ISO 8601 with time zone.
  provider_id	string	Team member ID from list_services. Default: you.
  notes	string	Appointment notes.
  notify_client	boolean	Notify the client of the booking. Default: true.

  Example response

  {
    "appointment_id": "ap_771904",
    "status": "booked",
    "start": "2026-10-15T15:30:00-04:00",
    "end": "2026-10-15T16:30:00-04:00",
    "services": [
      {
        "name": "Gel Manicure",
        "price": 55
      }
    ],
    "provider": "Sam",
    "deposit_required": false,
    "client_notified": true
  }

• POST

  reschedule_appointment

  Move an appointment to a new time or provider.

  asks first write

  Changes the date, time and optionally the provider of one appointment, and returns the old and new time. It does not change the price; GlossGenius adjusts prices at checkout. Moving to another team member needs calendar access to that person. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/glossgenius/reschedule_appointment

  Input

  Input: reschedule_appointment

  Parameter	Type	Description
  appointment_id required	string	Appointment ID from list_appointments.
  start required	datetime	New start, ISO 8601 with time zone.
  provider_id	string	Team member ID from list_services. Default: you.
  notify_client	boolean	Notify the client by email and text. Default: true.

  Example response

  {
    "appointment_id": "ap_771920",
    "status": "rescheduled",
    "previous_start": "2026-10-12T11:00:00-04:00",
    "start": "2026-10-20T11:00:00-04:00",
    "end": "2026-10-20T12:00:00-04:00",
    "provider": "Sam",
    "client_notified": true
  }

• POST

  cancel_appointment

  Cancel one appointment, or this and all future appointments if it repeats.

  asks first write

  Cancels the appointment and removes it from your calendar, or the whole repeating series with whole_series. With notify_client on, GlossGenius emails and texts the client about the cancellation. Cancelling cannot be undone with Cotlet; book the client again with book_appointment. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/glossgenius/cancel_appointment

  Input

  Input: cancel_appointment

  Parameter	Type	Description
  appointment_id required	string	Appointment ID from list_appointments.
  scope	enum	this_one or whole_series. Default: this_one.
  notify_client	boolean	Notify the client by email and text. Default: true.

  Example response

  {
    "appointment_id": "ap_771935",
    "status": "cancelled",
    "scope": "this_one",
    "client_notified": true
  }

• POST

  add_client

  Create a client profile. Nothing is sent to the client.

  write

  Creates a profile and returns its client ID. It reaches no one: GlossGenius sends client notifications only for bookings and changes, to the contact details on the profile, so check that they are right. This call does not ask for your OK; delete the profile in GlossGenius to undo it.

  POST /api/v1/glossgenius/add_client

  Input

  Input: add_client

  Parameter	Type	Description
  name required	string	First and last name.
  email	string	Client email. Email or phone is required.
  phone	string	Client mobile number that can receive texts. Email or phone is required.
  birthday	date	Client birthday.

  Example response

  {
    "client_id": "cl_50412",
    "name": "Dana K.",
    "email": "dana@example.com",
    "phone": null
  }

• POST

  add_client_note

  Save a note or formula to a client profile. Notes are private to your business.

  write

  Adds a blank note under Notes and Forms on the client profile and returns its ID. It reaches no one, because client profiles are private to your business, so it does not ask for your OK. Delete the note in the client profile to undo it.

  POST /api/v1/glossgenius/add_client_note

  Input

  Input: add_client_note

  Parameter	Type	Description
  client_id required	string	Client ID from find_client.
  text required	string	Note text.

  Example response

  {
    "note_id": "nt_9014",
    "client_id": "cl_50377",
    "saved": true
  }

• POST

  block_time

  Add a personal time block so clients cannot book you then.

  asks first write

  Adds one personal block to the calendar, so clients cannot book you online during it. It does not touch appointments already on the calendar; run list_appointments for the same range first. It adds one block, not a repeating one. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/glossgenius/block_time

  Input

  Input: block_time

  Parameter	Type	Description
  start required	datetime	ISO 8601 with time zone.
  end required	datetime	ISO 8601 with time zone.
  description	string	For example "Vacation" or "Lunch break". Clients do not see it.
  provider_id	string	Team member ID from list_services. Default: you.

  Example response

  {
    "block_id": "bl_6120",
    "start": "2026-10-16T09:00:00-04:00",
    "end": "2026-10-16T18:00:00-04:00",
    "description": "Day off",
    "provider": "Sam"
  }

Each successful call uses credits for the work it takes; failed calls and timeouts cost nothing. A hard spend cap is on by default. Authenticate with the Authorization: Bearer header.