GoReminders API and MCP server Let your AI agent answer the replies and fill the calendar.

ToolWhat it doesAccess

• list_appointments Read the GoReminders calendar for a date range, optionally by appointment status. read

  Returns appointments in calendar order with customer, service, staff, location, label and status. GoReminders shows a yellow checkmark when the client confirmed, a red exclamation mark for a reschedule request and a black one for a cancel; this tool returns those as `status`. Nothing is changed.

  MCP callgoreminders_read → list_appointments

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

  Parameters

  Parameters: list_appointments

  Name	Type	Description
  from string	string	ISO date to start from. Defaults to today.
  to string	string	ISO date to end on. Defaults to seven days after `from`.
  status string	string	Optional filter: `confirmed`, `reschedule_requested`, `canceled` or `no_reply`.

  Example response

  {
    "from": "2026-11-14",
    "to": "2026-11-14",
    "appointments": [
      {
        "time": "09:00",
        "customer": "Example Client",
        "service": "Deep tissue, 60 min",
        "staff": "Jordan",
        "status": "confirmed"
      },
      {
        "time": "11:00",
        "customer": "Sample Customer",
        "service": "Swedish, 90 min",
        "staff": "Jordan",
        "status": "reschedule_requested"
      },
      {
        "time": "14:00",
        "customer": "Demo Guest",
        "service": "Deep tissue, 60 min",
        "staff": "Alex",
        "status": "no_reply"
      }
    ]
  }

• create_appointment Create an appointment, a recurring series or a group appointment, with its reminder sequence. writeAsks first

  Saving the appointment schedules its reminders by itself, so it reaches the client. A group appointment holds up to 100 clients and counts each one toward your monthly appointment limit; an appointment with reminder type `none` does not count. Each repeat of a recurring series gets its own reminders. By default you confirm each call; you can switch that off for this tool.

  MCP callgoreminders_write → create_appointment

  REST endpointPOST https://cotlet.dev/api/v1/goreminders/appointments

  Parameters

  Parameters: create_appointment

  Name	Type	Description
  customer string required	string	Customer name, or a customer group for a group appointment. A new name is saved to your customer list.
  start string required	string	ISO date and time. GoReminders accepts it up to 1 minute before the start.
  length_minutes number	number	Defaults to the service or account default length.
  reminder_type string	string	`text`, `email`, `both` or `none`. `none` blocks off time and sends nothing.
  messages string	string	Message template or message sequence name. Defaults to the Main Template.
  service string	string	Service from Settings > Services.
  staff string	string	Staff member from Settings > Staff.
  location string	string	Location from Settings > Locations.
  repeat string	string	Optional: frequency for a recurring series, for example `weekly`.
  repeat_times number	number	Optional: number of times to repeat.
  notes string	string	Internal notes, never shown to the client.

  Example input

  {
    "customer": "Example Client",
    "start": "2026-11-21T09:00",
    "service": "Deep tissue, 60 min",
    "staff": "Jordan",
    "reminder_type": "text",
    "messages": "Two-day and same-day",
    "repeat": "weekly",
    "repeat_times": 4
  }

  Example response

  {
    "customer": "Example Client",
    "start": "2026-11-21T09:00",
    "service": "Deep tissue, 60 min",
    "staff": "Jordan",
    "messages": "Two-day and same-day",
    "reminder_type": "text",
    "repeat": "weekly",
    "repeat_times": 4,
    "saved": true
  }

• update_appointment Move or edit an appointment, add a label, change who is in a group appointment, or delete it. writeAsks first

  A new date or time sends a new reminder on your reminder schedule. A label such as No-show is internal; a label set to stop reminders and follow-ups stops them for that appointment. A deleted appointment cannot be brought back by the agent. By default you confirm each call; you can switch that off for this tool.

  MCP callgoreminders_write → update_appointment

  REST endpointPATCH https://cotlet.dev/api/v1/goreminders/appointment

  Parameters

  Parameters: update_appointment

  Name	Type	Description
  action string required	string	One of `update`, `add_customer`, `remove_customer`, `delete`. `list` and `get` only read.
  appointment string required	string	Customer and start time of the appointment, as list_appointments returns it.
  fields object	object	For `update`: start, length_minutes, service, staff, location, label or notes.
  customer string	string	For `add_customer` and `remove_customer` on a group appointment.

  Example input

  {
    "action": "action",
    "appointment": "appointment"
  }

  Example response

  {
    "appointment": "Sample Customer, 2026-11-14 11:00",
    "start": "2026-11-15T10:00",
    "new_reminder": true,
    "saved": true
  }

• set_appointment_status Mark an appointment Confirmed, Reschedule Requested or Canceled by hand. writeAsks first

  The same status a client sets by replying C, R or X. GoReminders sends the client no notice when you change it by hand. Canceled stops the remaining reminders, and every appointment still counts toward your monthly limit whatever its status. By default you confirm each call; you can switch that off for this tool.

  MCP callgoreminders_write → set_appointment_status

  REST endpointPUT https://cotlet.dev/api/v1/goreminders/appointment-status

  Parameters

  Parameters: set_appointment_status

  Name	Type	Description
  appointment string required	string	Customer and start time, as list_appointments returns it.
  status string required	string	One of `confirmed`, `reschedule_requested`, `canceled`.

  Example input

  {
    "appointment": "appointment",
    "status": "status"
  }

  Example response

  {
    "appointment": "Demo Guest, 2026-11-14 14:00",
    "status": "confirmed",
    "saved": true
  }

ToolWhat it doesAccess

• list_messages Read the Messages inbox: texts and emails sent and the replies customers sent back. read

  Newest first. Use it each morning to find reschedule requests and questions that need an answer. It changes nothing and runs without asking.

  MCP callgoreminders_read → list_messages

  REST endpointGET https://cotlet.dev/api/v1/goreminders/messages

  Parameters

  Parameters: list_messages

  Name	Type	Description
  customer string	string	Only messages with this customer.
  replies_only boolean	boolean	Only replies from customers, including C, R and X answers to reminders.
  since string	string	ISO date and time; only newer messages.

  Example response

  {
    "messages": [
      {
        "customer": "Sample Customer",
        "at": "2026-11-13T18:42",
        "direction": "in",
        "text": "R"
      },
      {
        "customer": "Example Client",
        "at": "2026-11-13T17:05",
        "direction": "in",
        "text": "C"
      }
    ]
  }

• send_message Send one customer a text or email from the Messages tab, with an optional pay link or file link. writeAsks first

  Two-way messaging is a GoReminders add-on. A pay link needs payment processing set up in GoReminders. The message goes out from your dedicated GoReminders number or email and cannot be recalled. By default you confirm each call; you can switch that off for this tool.

  MCP callgoreminders_write → send_message

  REST endpointPOST https://cotlet.dev/api/v1/goreminders/messages

  Parameters

  Parameters: send_message

  Name	Type	Description
  customer string required	string	Existing customer, or a new name with a phone or email.
  text string required	string	The message.
  pay_amount number	number	Optional: adds a pay link for this amount (Add Pay Link).
  invoice_label string	string	With `pay_amount`: the Invoice Label the client sees.
  file string	string	Optional: a file from manage_files to share as a link.

  Example input

  {
    "customer": "customer",
    "text": "text"
  }

  Example response

  {
    "customer": "Sample Customer",
    "text": "No problem, would Saturday at 10 work? Deposit link below.",
    "pay_link": {
      "amount": 40,
      "invoice_label": "Deposit, Swedish 90 min"
    },
    "sent": true
  }

• send_message_blast List past blasts, or send a new text and email blast to a group, optionally copied from an old one. writeAsks first

  Message Blasts are an add-on, and GoReminders asks for some business information before the first one. Recipients do not see each other, and they can reply as they do to reminders. `preview` returns the blast as it will go out; `send` reaches every recipient at once. By default you confirm each call; you can switch that off for this tool.

  MCP callgoreminders_write → send_message_blast

  REST endpointPOST https://cotlet.dev/api/v1/goreminders/message-blasts

  Parameters

  Parameters: send_message_blast

  Name	Type	Description
  action string required	string	One of `list`, `preview`, `send`. `list` and `get` only read.
  name string	string	Blast Name, for `preview` and `send`.
  send_to string	string	Customer group or customers.
  text string	string	Text version of the message.
  email string	string	Email version; defaults to the text.
  duplicate_of string	string	Optional: a previous blast to copy, as Duplicate does.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "blasts": [
      {
        "name": "Holiday gift cards",
        "sent_to": "Monthly members",
        "recipients": 42,
        "replies": 7
      },
      {
        "name": "December hours",
        "sent_to": "All customers",
        "recipients": 318,
        "replies": 12
      },
      {
        "name": "New hot stone service",
        "sent_to": "Monthly members",
        "recipients": 42,
        "replies": 9
      }
    ]
  }

• manage_files List, upload or share the files and photos on an appointment or a customer. writeAsks first

  Files are private by default. `share` makes a public link anyone with it can open; send it with send_message. By default you confirm each call; you can switch that off for this tool.

  MCP callgoreminders_write → manage_files

  REST endpointPOST https://cotlet.dev/api/v1/goreminders/files/manage

  Parameters

  Parameters: manage_files

  Name	Type	Description
  action string required	string	One of `list`, `upload`, `share`. `list` and `get` only read.
  appointment string	string	Appointment to attach to.
  customer string	string	Customer to attach to, without an appointment.
  file_url string	string	For `upload`: a link the Cloud Browser can download the file from.
  file string	string	For `share`: the file to share.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "customer": "Example Client",
    "file": "Intake form.pdf",
    "share_link": "https://files.example.com/s/abc123",
    "shared": true
  }

ToolWhat it doesAccess

• manage_message_templates List, create, edit, rename or delete the SMS and email message templates your reminders use. writeAsks first

  Every future reminder that uses the template carries the change, so edits wait for your OK. GoReminders adds the reply C, R or X instructions to reminders unless you turned them off in Settings > Reminders. Trial accounts cannot put links in templates until GoReminders approves them. By default you confirm each call; you can switch that off for this tool.

  MCP callgoreminders_write → manage_message_templates

  REST endpointPOST https://cotlet.dev/api/v1/goreminders/message-templates/manage

  Parameters

  Parameters: manage_message_templates

  Name	Type	Description
  action string required	string	One of `list`, `get`, `create`, `update`, `delete`. `list` and `get` only read.
  template string	string	Template name; `Main Template` is the default.
  sms string	string	SMS/Text version, with template tags such as {{First Name}}, {{Day Name}}, {{Date}}, {{Time}}, {{Service}}, {{Location}} or {{Booking Link}}.
  email string	string	Email version.
  new_name string	string	For `update`: rename the template.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "template": "Two-day reminder",
    "sms": "Hi {{First Name}}, see you {{Day Name}}, {{Date}} at {{Time}} for your {{Service}}.",
    "saved": true
  }

• manage_message_sequences List or set the message sequences: which template goes out when, plus follow-ups after the visit. writeAsks first

  Follow-up messages are an add-on; they suit review requests and rebooking nudges, and never carry the confirm or reschedule instructions. A deleted sequence cannot be undone. By default you confirm each call; you can switch that off for this tool.

  MCP callgoreminders_write → manage_message_sequences

  REST endpointPOST https://cotlet.dev/api/v1/goreminders/message-sequences/manage

  Parameters

  Parameters: manage_message_sequences

  Name	Type	Description
  action string required	string	One of `list`, `create`, `update`, `delete`. `list` and `get` only read.
  sequence string	string	Sequence Name, the one you pick in the Message(s) field of an appointment.
  reminders array	array	For `create` and `update`: each reminder's schedule (immediately, or a number of hours or days before) and its message template.
  follow_ups array	array	Optional: up to two follow-up messages, each with a template and a delay from 1 hour to 3 years after the appointment.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "sequence": "Two-day and same-day",
    "reminders": [
      {
        "when": "2 days before",
        "template": "Two-day reminder"
      },
      {
        "when": "3 hours before",
        "template": "Same-day reminder"
      }
    ],
    "follow_ups": [
      {
        "when": "1 day after",
        "template": "Review request"
      }
    ],
    "saved": true
  }

ToolWhat it doesAccess

• manage_booking_requests List the booking requests from your Booking Form, or confirm one at a chosen time. writeAsks first

  Requests come in when your Booking Style is Appointment Request. `list` returns each customer with the times they asked for. `confirm` picks one, saves the appointment and starts its reminders, so the client hears from you. By default you confirm each call; you can switch that off for this tool.

  MCP callgoreminders_write → manage_booking_requests

  REST endpointPOST https://cotlet.dev/api/v1/goreminders/booking-requests/manage

  Parameters

  Parameters: manage_booking_requests

  Name	Type	Description
  action string required	string	One of `list`, `confirm`. `list` and `get` only read.
  customer string	string	For `confirm`: the customer who sent the request.
  slot string	string	For `confirm`: one of the requested dates and times, ISO.
  messages string	string	For `confirm`: message template or sequence for the reminders.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "requests": [
      {
        "customer": "New Client",
        "service": "Swedish, 90 min",
        "requested": [
          "2026-11-18T10:00",
          "2026-11-19T15:00"
        ]
      }
    ]
  }

• manage_booking_settings Read or change the Booking Form: on or off, booking style, open hours, time slots, and get a prefilled link. writeAsks first

  `link` builds the Booking Form URL with the ?date= and prefill parameters GoReminders documents. A length shorter than the time selector interval leaves gaps between bookings. Client Self-Scheduling is an add-on. Hours and style change what every client can book, so `update` waits for your OK. By default you confirm each call; you can switch that off for this tool.

  MCP callgoreminders_write → manage_booking_settings

  REST endpointPOST https://cotlet.dev/api/v1/goreminders/booking-settings/manage

  Parameters

  Parameters: manage_booking_settings

  Name	Type	Description
  action string required	string	One of `get`, `update`, `link`. `list` and `get` only read.
  fields object	object	For `update`: booking_enabled, booking_style (`instant_book` or `appointment_request`), open_hours per day with breaks, time_selector_interval and default_length.
  date string	string	For `link`: optional ISO date and time to preselect.
  customer string	string	For `link`: optional customer whose name, email and phone are prefilled.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "booking_enabled": true,
    "booking_style": "appointment_request",
    "time_selector_interval": 60,
    "default_length": 45,
    "link": "https://example.goreminders.com/book?date=20261118T1000"
  }

ToolWhat it doesAccess

• manage_customers Search, read, add, edit, import or delete customers. writeAsks first

  `get` also returns the customer's past and upcoming appointments. Setting reminder type to `none` and clearing phone and email is how GoReminders stops a contact from messaging you. A deleted customer cannot be restored. By default you confirm each call; you can switch that off for this tool.

  MCP callgoreminders_write → manage_customers

  REST endpointPOST https://cotlet.dev/api/v1/goreminders/customers/manage

  Parameters

  Parameters: manage_customers

  Name	Type	Description
  action string required	string	One of `list`, `get`, `create`, `update`, `import`, `delete`. `list` and `get` only read.
  customer string	string	Name, email or phone, for `get`, `update` and `delete`.
  fields object	object	For `create` and `update`: name (required on create), email, phone, time_zone, reminder_type (`email`, `text`, `both`, `none`), notes and your custom fields.
  csv_url string	string	For `import`: a CSV with the headers First Name, Last Name, Email, Phone.
  group string	string	For `import`: optional customer group to import into.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "customer": "Example Client",
    "email": "client@example.com",
    "phone": "+1 555 0100",
    "reminder_type": "text",
    "upcoming": 2,
    "past": 9
  }

• manage_customer_groups List customer groups, create one, or add and remove members. writeAsks first

  Groups are what group appointments and message blasts are sent to. Changing a group reaches no one by itself, but the next blast to it does. By default you confirm each call; you can switch that off for this tool.

  MCP callgoreminders_write → manage_customer_groups

  REST endpointPOST https://cotlet.dev/api/v1/goreminders/customer-groups/manage

  Parameters

  Parameters: manage_customer_groups

  Name	Type	Description
  action string required	string	One of `list`, `create`, `add`, `remove`. `list` and `get` only read.
  group string	string	Group name.
  customers array	array	For `create`, `add` and `remove`: customer names.

  Example input

  {
    "action": "action"
  }

  Example response

  {
    "group": "Monthly members",
    "customers": 42,
    "saved": true
  }

• manage_setup_items List or change the services, staff members, locations and labels appointments use. writeAsks first

  Services and staff can show on your Booking Form, and their template tags reach clients in reminders. Labels are internal only. By default you confirm each call; you can switch that off for this tool.

  MCP callgoreminders_write → manage_setup_items

  REST endpointPOST https://cotlet.dev/api/v1/goreminders/setup-items/manage

  Parameters

  Parameters: manage_setup_items

  Name	Type	Description
  kind string required	string	One of `service`, `staff`, `location`, `label`.
  action string required	string	One of `list`, `create`, `update`, `delete`. `list` and `get` only read.
  name string	string	Name of the item.
  fields object	object	Service: default length. Staff: email, phone and whether confirmation notices and SMS replies are forwarded to them. Location: internal label and the text clients see. Label: whether it stops reminders and follow-ups.

  Example input

  {
    "kind": "kind",
    "action": "action"
  }

  Example response

  {
    "kind": "service",
    "name": "Hot stone, 75 min",
    "fields": {
      "default_length": 75
    },
    "saved": true
  }