Goldie API and MCP server Let your AI agent run the front desk of your chair.

ToolWhat it doesAccess

• manage_appointments Read your Goldie calendar for a day, or create an appointment. writeAsks first

  Goldie needs a client and a service for every appointment; date and time come from the slot. If you set a default message template, Goldie fills in the message to the client, so a new appointment can reach your client. `list` returns the day's appointments with client, service and time. By default you confirm each call; you can switch that off for this tool.

  MCP callgoldie_write → manage_appointments

  REST endpointPOST https://cotlet.dev/api/v1/goldie/appointments/manage

  Parameters

  Parameters: manage_appointments

  Name	Type	Description
  action string required	string	One of `list`, `get`, `create`. `list` and `get` only read.
  date string	string	ISO date, for `list` and `create`. `list` defaults to today.
  time string	string	Start time, for `create`, for example 14:30.
  client string	string	Client name from manage_clients. Required for `create`.
  services array	array	Service names from manage_services. Required for `create`.
  products array	array	Optional products sold with the appointment.
  notes string	string	Optional note, saved under More.
  location string	string	Optional location, saved under More.
  discount string	string	Optional discount as an amount or a percentage, for example 10%.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "date": "2026-11-18",
    "appointments": [
      {
        "time": "10:00",
        "client": "Example Client A",
        "services": [
          "Gel manicure"
        ],
        "amount": 45
      },
      {
        "time": "14:30",
        "client": "Example Client B",
        "services": [
          "Brow lamination"
        ],
        "amount": 60
      }
    ]
  }

• reschedule_appointment Move a Goldie appointment to another day or time. writeAsks first

  Goldie notifies the client of the change automatically when you reschedule, so the agent shows you the old and new slot before it saves. By default you confirm each call; you can switch that off for this tool.

  MCP callgoldie_write → reschedule_appointment

  REST endpointPOST https://cotlet.dev/api/v1/goldie/appointment/reschedule

  Parameters

  Parameters: reschedule_appointment

  Name	Type	Description
  appointment string required	string	The appointment, by client and current date, as manage_appointments returns it.
  date string required	string	New ISO date.
  time string	string	New start time. Leave empty to keep the same time.

  Example input

  {
    "appointment": "appointment",
    "date": "date"
  }

  Example response

  {
    "client": "Example Client B",
    "service": "Brow lamination",
    "from": "2026-11-18T14:30",
    "to": "2026-11-20T11:00",
    "client_notified": true
  }

ToolWhat it doesAccess

• manage_clients List or open your Goldie clients, or add a new one. writeAsks first

  Goldie keeps clients under Menu, then Clients. Run `list` first so the same client is not added twice; appointments, payments and mass messages all point at these records. By default you confirm each call; you can switch that off for this tool.

  MCP callgoldie_write → manage_clients

  REST endpointPOST https://cotlet.dev/api/v1/goldie/clients/manage

  Parameters

  Parameters: manage_clients

  Name	Type	Description
  action string required	string	One of `list`, `get`, `create`. `list` and `get` only read.
  client string	string	Client name, for `get`, or a search for `list`.
  fields object	object	For `create`: name, phone, email and notes.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "client": "Example Client C",
    "phone": "+1 555 0100",
    "email": "client@example.com",
    "notes": "Prefers almond shape",
    "saved": true
  }

• manage_services List your Goldie services, add one or change its price, duration or online booking. writeAsks first

  Changes show on your online booking site, so the agent tells you which service and fields it changes. Deposit and card rules for a service are set in Goldie's no-show protection, which this tool leaves as it is. By default you confirm each call; you can switch that off for this tool.

  MCP callgoldie_write → manage_services

  REST endpointPOST https://cotlet.dev/api/v1/goldie/services/manage

  Parameters

  Parameters: manage_services

  Name	Type	Description
  action string required	string	One of `list`, `create`, `update`. `list` only read.
  service string	string	Service name, for `create` and `update`.
  category string	string	Service category. A new service is Uncategorized until you pick one.
  price_type string	string	`fixed` with an amount, or `variable` with a text such as a price range.
  price string	string	The amount for `fixed`, the text for `variable`.
  duration_minutes number	number	From 5 minutes up to 23 hours.
  processing_minutes number	number	Optional processing time after the service that other clients can book online.
  extra_minutes number	number	Optional blocked extra time, for cleaning or travel.
  online_booking boolean	boolean	Available for online booking. Off hides the service from your booking site.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "service": "Gel manicure",
    "category": "Nails",
    "price_type": "fixed",
    "price": "45",
    "duration_minutes": 60,
    "online_booking": true,
    "saved": true
  }

• set_online_booking Read or switch Goldie's "Let customers book online" setting. writeAsks first

  The setting sits under Menu, Settings, Online Booking. Turning it off stops new online bookings at once, so the agent asks first and tells you the state it found. By default you confirm each call; you can switch that off for this tool.

  MCP callgoldie_write → set_online_booking

  REST endpointPUT https://cotlet.dev/api/v1/goldie/online-booking

  Parameters

  Parameters: set_online_booking

  Name	Type	Description
  action string required	string	One of `get`, `set`. `get` only read.
  enabled boolean	boolean	For `set`: true lets customers book online, false stops it.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "setting": "Let customers book online",
    "enabled": true
  }

ToolWhat it doesAccess

• take_client_payment Take a deposit or the full payment for an appointment at Goldie checkout. writeAsks first

  Needs Goldie payments set up and a user with permission to take payments. Checkout shows the client's name, which the agent repeats with the amount before it charges. The tip screen is skipped for deposits. By default you confirm each call; you can switch that off for this tool.

  MCP callgoldie_write → take_client_payment

  REST endpointPOST https://cotlet.dev/api/v1/goldie/client-payment/take

  Parameters

  Parameters: take_client_payment

  Name	Type	Description
  appointment string required	string	The appointment, by client and date.
  kind string required	string	`deposit` or `full`. `full` charges the remaining balance.
  amount number	number	For `deposit`: defaults to the deposit from your settings and cannot exceed the appointment total.
  method string required	string	A payment method your Goldie checkout offers. Split payment is not available for deposits.

  Example input

  {
    "appointment": "appointment",
    "kind": "kind",
    "method": "method"
  }

  Example response

  {
    "client": "Example Client A",
    "appointment": "2026-11-18T10:00",
    "kind": "deposit",
    "amount": 15,
    "method": "Card",
    "paid": true
  }

• refund_client_payment List an appointment's transactions or refund one in full or in part. writeAsks first

  Needs Goldie Payments and a user allowed to issue refunds. You can refund part of a transaction more than once until nothing is left; `list` shows what is still available. Money goes back to your client, so every refund waits for your OK. By default you confirm each call; you can switch that off for this tool.

  MCP callgoldie_write → refund_client_payment

  REST endpointPOST https://cotlet.dev/api/v1/goldie/client-payment/refund

  Parameters

  Parameters: refund_client_payment

  Name	Type	Description
  action string required	string	One of `list`, `refund`. `list` only read.
  appointment string	string	The appointment, by client and date. Or leave empty and give `transaction`.
  transaction string	string	A transaction from your Payments dashboard.
  amount number	number	For `refund`: leave empty to refund all that is left, or give part of it. No minimum.
  method string	string	For card payments: `card` (card used at payment) or `cash`.

  Example input

  {
    "action": "refund",
    "appointment": "Example Client B, 2026-11-18",
    "amount": 20,
    "method": "card"
  }

  Example response

  {
    "client": "Example Client B",
    "transaction": "Brow lamination, card",
    "amount": 20,
    "available_after": 40,
    "method": "card",
    "refunded": true
  }

ToolWhat it doesAccess

• send_mass_message Read your mass message history or send a message to a group of clients. writeAsks first

  For Goldie Pro and Pro Plus, under Menu, Marketing, Mass Message. The agent sends through Goldie's own messaging system, which Goldie offers in certain countries only; sending from your phone carrier stays on your phone. It reads the message and recipients back to you before each group goes out. By default you confirm each call; you can switch that off for this tool.

  MCP callgoldie_write → send_mass_message

  REST endpointPOST https://cotlet.dev/api/v1/goldie/mass-messages

  Parameters

  Parameters: send_mass_message

  Name	Type	Description
  action string required	string	One of `history`, `send`. `history` only read.
  message string	string	For `send`: the text your clients receive.
  recipients string	string	For `send`: the clients to include, as Goldie's Recipients picker offers them.
  group_size number	number	For `send`: how many clients go in each group.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "message": "Free nail art on Tuesday appointments this month.",
    "groups": 2,
    "sent": 48
  }

• export_goldie_data Ask Goldie to email you an export of your clients, appointments, services and account data. read

  Starts My Account, Export Data. Goldie emails a ZIP file within about 15 minutes, and the download link expires after seven days. On Pro Plus only the Account Owner can export. Nothing in Goldie changes, so it runs without asking.

  MCP callgoldie_read → export_goldie_data

  REST endpointGET https://cotlet.dev/api/v1/goldie/goldie-datas/export

  Parameters

  No parameters.

  Example response

  {
    "requested": true,
    "delivery": "email",
    "contents": [
      "Clients",
      "Appointments",
      "Services",
      "User Account"
    ],
    "link_expires_days": 7
  }