MCP App Store
by KeenEthics
Qminder icon

Qminder MCP Server for ChatGPT

By Qminder

Overview

Bring your Qminder queue management into ChatGPT. Check scheduled appointments, see which customers are waiting, and call the next person in line—all by asking naturally. You can also view all your locations at a glance, and monitor iPad and TV status. A simple way to stay on top of customer flow without leaving the conversation.

How to connect

  1. ChatGPT: Open the Qminder listing in the ChatGPT app directory and choose Connect. ChatGPT listing Qminder exposes 20 tools here.

Tools

archive_service

ChatGPT
Archives one or more services in a location. Services are the queues visitors join. Archived services stop accepting visitors and drop out of the location's active list, but their history is kept and they can be restored later. Identify the services to archive by id, by name, or both — provide at least one list. REQUIRED: - locationId: The location the services belong to. - serviceIds and/or serviceNames (at least one): - serviceIds: The ids of the services to archive. - serviceNames: The names of the services to archive. Each name must match exactly one service of the location (case-insensitive). Use serviceIds when a name is not unique. IMPORTANT: A location must keep at least one active service — archiving the last active service fails. RETURN VALUE: JSON with the archived service ids, e.g. { "archivedServiceIds": [1, 2] }.

call_next_ticket

ChatGPT
Call next ticket for the authenticated user's account

create_input_field

ChatGPT
Creates a single input field for a location. Input fields are the data points collected from visitors. REQUIRED: - locationId: The location to add the input field to. - type: One of PHONE_NUMBER, URL, SELECT, TEXT, EMAIL, DATE, FIRST_NAME, LAST_NAME, NUMERIC, ATTACHMENT. - title: Required for TEXT, SELECT, URL, DATE, NUMERIC and ATTACHMENT fields. SELECT FIELDS: - multiSelect: Whether more than one option can be chosen. - options: The selectable options (each with a title and an optional hex color). VISIBILITY (all optional, default false): - isMandatoryBeforeAdded, isMandatoryBeforeServed, isMandatoryInRemoteSignIn, isVisibleInWaitingDrawer, isVisibleInServingDrawer, showInRemoteSignIn. LINES: - lineIds: The lines the field is visible for. When omitted, the field is made visible for all lines in the location. SINGLETON TYPES: FIRST_NAME, LAST_NAME, EMAIL and PHONE_NUMBER can exist only once per location; creating a duplicate returns a conflict error. RETURN VALUE: JSON with the id of the created input field, e.g. { "id": "..." }.

create_location

ChatGPT
Creates a single location for the authenticated user's account, optionally copying settings from a template location. To also create a visitor website for it, call create_visitor_website afterwards with the returned location id. REQUIRED FIELDS: - name: Location name (max 30 characters) - address: Street address (max 300 characters) - country: ISO 3166-1 alpha-2 country code, uppercase (e.g. "US", "GB", "EE") - latitude: -90 to 90 - longitude: -180 to 180 COPYING FROM A TEMPLATE (optional): Provide copyFromLocationId to copy settings from an existing template location, and toggle which aspects to copy. Copying from a template also brings over the template's languages, service settings, and opening hours. When copyFromLocationId is omitted, the location is created with system defaults (2 lines, 3 desks, default input fields, 24/7 hours, English). RETURN VALUE: JSON object with the created location id, e.g. { "id": "123" }.

create_service

ChatGPT
Creates a service for a location. Services are the queues visitors join. REQUIRED: - locationId: The location to add the service to. - name: The service name. - color: One of VIOLET, LAVENDER, MARSHMALLOW, TEAL, MINT, CORAL, YELLOW, ROSE, INDIGO, BLUE. OPTIONAL: - disabled: Whether the service starts disabled. Defaults to false. - translations: Per-language names, each with a languageCode and name. - appointmentSettings: Appointment booking settings — enabled, plus a duration in minutes (one of 15, 30, 45, 60, 90, 120, 180). RETURN VALUE: JSON with the id of the created service, e.g. { "id": 123 }.

create_visitor_website

ChatGPT
Creates the visitor website for a location, copying the settings of a template location's website. Use this after create_location: pass the new location id, the desired url, and the template location id. REQUIRED: - locationId: id of the location to attach the website to (e.g. from create_location) - url: public subdomain slug -> https://{url}.qminder.site. Lowercase letters, digits and hyphens only, 2-100 characters, GLOBALLY UNIQUE across all accounts. The call fails if the url is already taken; retry with a different slug. - name: display name of the website - templateLocationId: id of a location whose existing visitor website holds the settings to copy: description, notes, contact details, branding (accent color), visibility flags, geofencing, appointment windows, and translations (per-language name/description/notes, plus remote sign-in success message translations when enableRemoteSignIn is set). NOTE: the template's remote sign-in line selection and logo are NOT copied. OPTIONAL: - enableRemoteSignIn (default false): when true, turns on remote sign-in (join waitlist) for the website, enabled for ALL of the location's active lines. RETURN VALUE: JSON like { "locationId": "123", "url": "aa-tartu", "status": "created" }.

edit_input_field

ChatGPT
Updates an existing input field. Only the properties you provide are changed; everything you omit is left as-is. REQUIRED: - inputFieldId: The id of the input field to update (a UUID, as returned by get_input_fields). UPDATABLE PROPERTIES (all optional): - title, visitorFacingTitle - visibleForLineIds: replaces the set of lines the field is visible for - isVisibleInWaitingDrawer, isVisibleInServingDrawer, isMandatoryInRemoteSignIn, showInRemoteSignIn, isMandatoryBeforeAdded, isMandatoryBeforeServed - multiSelect, options (SELECT fields; options fully replace the existing ones) - translations (fully replace the existing translations) - constraints (NUMERIC fields: min, max, scale) RETURN VALUE: JSON with the id of the updated input field, e.g. { "id": "..." }.

edit_service

ChatGPT
Updates a service in a location. Services are the queues visitors join. This is a full update: name and color are required, and any optional property you omit is reset to its default (translations cleared, appointment booking removed, enabled). To change one property without losing the others, read the current values with get_services first and pass them all back. REQUIRED: - locationId: The location the service belongs to. - serviceId: The id of the service to update. - name: The service name. - color: One of VIOLET, LAVENDER, MARSHMALLOW, TEAL, MINT, CORAL, YELLOW, ROSE, INDIGO, BLUE. OPTIONAL: - disabled: Whether the service is disabled. Defaults to false. - translations: Per-language names, each with a languageCode and name. - appointmentSettings: Appointment booking settings — enabled, plus a duration in minutes (one of 15, 30, 45, 60, 90, 120, 180). RETURN VALUE: JSON with the id of the updated service, e.g. { "id": 123 }.

edit_visitor_website

ChatGPT
Changes the visitor website of a location. Only the fields that you supply change. All other fields keep their current values. The location must have a visitor website. REQUIRED: - locationId: the id of the location OPTIONAL. Supply only the fields that you must change: - name: the display name of the website. It must not be empty. - description: the description on the website - email, phoneNumber: the contact details - notes: the notes for visitors - brandAccentColor: a hex color. Example: "#af0001" - remoteSignInSuccessMessage: the message for a visitor who joins the waitlist - geofencingRadiusMm: the radius in millimetres - geofencingEnabledForRemoteSignIn, geofencingEnabledForAppointmentCheckIn: true or false SERVICE LINES FOR REMOTE SIGN-IN: - remoteSignInEnabled: true or false. It turns the waitlist on or off for the website. - remoteSignInLineNames: the names of the lines to select. Example: ["Consultation", "Sales"] - remoteSignInLineIds: the ids of the lines to select. Use this if a name is ambiguous. Supply remoteSignInLineNames or remoteSignInLineIds, but not both. The list must have a minimum of one line. The new list replaces the old list. Only active lines of the location are valid. A disabled or archived line is not valid. A line list does not turn the waitlist on. To turn the waitlist on, also set remoteSignInEnabled to true. If you turn the waitlist off, the tool keeps the line selection. A website whose waitlist is on must always have a minimum of one line. If the waitlist is on and the website has no line, each change of the website fails until you supply a line list or set remoteSignInEnabled to false. TRANSLATIONS: - translations: the name, description and notes for each language. Example: [{ "languageCode": "et", "description": "Kirjeldus" }] - remoteSignInSuccessMessageTranslations: the waitlist message for each language. Example: [{ "languageCode": "et", "successMessage": "Tere tulemast" }] Each language that you do not supply keeps its current text. In a language that you supply, each field that you do not supply keeps its current text. HOW TO CLEAR A FIELD: Supply an empty string "". You can clear description, email, phoneNumber, notes, brandAccentColor and remoteSignInSuccessMessage. If you do not supply a field, that field does not change. An absent field does NOT become empty. RETURN VALUE: JSON. Example: { "locationId": "123", "status": "updated", "changed": ["description", "brandAccentColor"] } The field remoteSignInEnabled is present only if you change the waitlist. The field remoteSignInLines is present only if you change the lines or turn the waitlist on.

get_all_locations

ChatGPT
Retrieves all locations for the authenticated user's account. DEFAULT FIELDS (always included): - id, name: Always returned for each location OPTIONAL RESOURCES (included only when you specify their fields): - ipads: Include by specifying ipadFields - tvs: Include by specifying tvFields - desks: Include by specifying deskFields - lines: Include by specifying lineFields - users: Include by specifying userFields - languages: Include by specifying languageFields VALID FIELD VALUES: - basicFields: address, countryCode, country, timezone, created, latitude, longitude, smsEnabled, isDemo - ipadFields: id, name, online, charging, batteryLevel - tvFields: id, name, theme, layout, online - deskFields: id, name, user (user returns nested object with id, email) - lineFields: id, name, color, disabled, archived - userFields: id, email, firstName, lastName - languageFields: code, name, nativeName, primary RETURN VALUE: JSON array of location objects with requested fields and nested resources. EXAMPLES: Example 1 - Minimal (just id and name): {} Example 2 - Locations with address info: { "basicFields": ["address", "country", "timezone"] } Example 3 - Locations with lines and users: { "lineFields": ["id", "name", "color"], "userFields": ["id", "email", "firstName"] } Example 4 - Full location details: { "basicFields": ["address", "timezone", "country", "smsEnabled"], "lineFields": ["id", "name", "color", "disabled"], "deskFields": ["id", "name", "user"], "userFields": ["id", "email", "firstName", "lastName"], "ipadFields": ["id", "name", "online"] }

get_appointments

ChatGPT
Get scheduled appointments for a location within a date range. Returns appointment times, assigned staff, and optional customer/ticket details. CRITICAL TIMEZONE REQUIREMENT: ALL RETURNED TIMES (startTime, endTime) ARE IN UTC TIMEZONE. YOU MUST CONVERT TO THE LOCATION'S TIMEZONE BEFORE DISPLAYING TO USERS. The location's timezone is provided in the location data - use it for all time conversions. DEFAULT FIELDS (always included): - id: Ticket ID - appointment { startTime, endTime, assignee { id, firstName, lastName, email } } OPTIONAL RESOURCES (included only when you specify their fields): - line: Include by specifying lineFields - fields: Include by specifying fieldsFields (custom fields) - labels: Include by specifying labelsFields - language: Include by specifying languageFields Common use cases: 1. View today's appointments with customer details: - Set startDate/endDate to today's date range - Add basicFields: ["status", "firstName", "lastName", "phoneNumber"] 2. Check specific staff member's schedule: - Use assigneeIds: [456, 789] - Appointments assigned to these users only 3. Filter by appointment status: - statuses: ["SCHEDULED"] for upcoming appointments - statuses: ["SCHEDULING_NOSHOW", "SCHEDULING_CANCELLED", "SCHEDULING_CANCELLED_BY_VISITOR"] for no-shows and cancellations 4. Export with full context: - Add lineFields: ["id", "name", "color"] - Add labelsFields: ["value", "color"] - Add fieldsFields: ["id", "value", "options", "inputField"] FILTERS: - assigneeIds: Filter by staff member IDs - lineIds: Filter by service line IDs - statuses: SCHEDULED, CALLED, SERVED, SCHEDULING_CANCELLED, SCHEDULING_CANCELLED_BY_VISITOR, SCHEDULING_NOSHOW - limit: Max results (default 100, max 1000) VALID FIELD VALUES: - basicFields: status, firstName, lastName, phoneNumber, email - lineFields: id, name, color - fieldsFields: id, value, options, inputField - labelsFields: value, color - languageFields: code, name Date format: ISO 8601 with timezone, e.g., "2025-01-15T14:30:00.000Z"

get_current_user

ChatGPT
Retrieves information about the currently authenticated user. DEFAULT FIELDS (always included): - id, email: Always returned - selectedLocation: Always returned with default fields [id, name, timezone] You can customize selectedLocation fields using selectedLocationFields parameter. OPTIONAL RESOURCES (included only when you specify their fields): - profilePicture: Include by specifying profilePictureFields - selectedDesk: Include by specifying selectedDeskFields - selectedLines: Include by specifying selectedLinesFields - roles: Include by specifying roleFields VALID FIELD VALUES: - basicFields: firstName, lastName, created, lastLoggedIn, lastInvited, deleted, deletedAt - selectedLocationFields: id, name, timezone, address, country (default: [id, name, timezone]) - selectedDeskFields: id, name - selectedLinesFields: id, name, color, disabled, archived - profilePictureFields: medium, large - roleFields: type, location (location returns nested object with id and name) RETURN VALUE: JSON object containing user data with requested fields and nested resources. EXAMPLES: Example 1 - Minimal (id, email, selectedLocation with defaults): {} Example 2 - Basic user info with custom location fields: { "basicFields": ["firstName", "lastName"], "selectedLocationFields": ["id", "name", "timezone", "address"] } Example 3 - User with profile picture: { "profilePictureFields": ["medium"] } Example 4 - Full profile with all resources: { "basicFields": ["firstName", "lastName", "created"], "selectedLocationFields": ["id", "name", "timezone", "address"], "selectedDeskFields": ["id", "name"], "selectedLinesFields": ["id", "name", "color"], "profilePictureFields": ["medium", "large"], "roleFields": ["type", "location"] }

get_input_fields

ChatGPT
Retrieves the input fields configured for a location. Input fields are the data points collected from visitors (e.g. name, phone number, a custom SELECT or TEXT field). REQUIRED: - locationId: The location to read input fields from. RETURN VALUE: JSON with the full data for each input field: id, type, title, visitorFacingTitle, mandatory/visibility flags, multiSelect, options (with colors and translations), visibleForLines, numeric constraints, and translations.

get_location_by_id

ChatGPT
Retrieves location by id for the authenticated user's account. DEFAULT FIELDS (always included): - id, name: Always returned OPTIONAL RESOURCES (included only when you specify their fields): - ipads: Include by specifying ipadFields - tvs: Include by specifying tvFields - desks: Include by specifying deskFields - lines: Include by specifying lineFields - users: Include by specifying userFields - languages: Include by specifying languageFields VALID FIELD VALUES: - basicFields: address, countryCode, country, timezone, created, latitude, longitude, smsEnabled, isDemo - ipadFields: id, name, online, charging, batteryLevel - tvFields: id, name, theme, layout, online - deskFields: id, name, user (user returns nested object with id, email) - lineFields: id, name, color, disabled, archived - userFields: id, email, firstName, lastName - languageFields: code, name, nativeName, primary RETURN VALUE: JSON object of location with requested fields and nested resources. EXAMPLES: Example 1 - Minimal (just id and name): { "id": 123 } Example 2 - Location with address info: { "id": 123, "basicFields": ["address", "country", "timezone"] } Example 3 - Location with lines and users: { "id": 123, "lineFields": ["id", "name", "color"], "userFields": ["id", "email", "firstName"] } Example 4 - Full location details: { "id": 123, "basicFields": ["address", "timezone", "country", "smsEnabled"], "lineFields": ["id", "name", "color", "disabled"], "deskFields": ["id", "name", "user"], "userFields": ["id", "email", "firstName", "lastName"] }

get_services

ChatGPT
Retrieves the services configured for a location. Services are the queues visitors join (e.g. "Returns", "Customer support", "Prescriptions"). REQUIRED: - locationId: The location to read services from. OPTIONAL: - includeArchived: Whether to also return archived services. Defaults to false (only active and disabled services are returned). RETURN VALUE: JSON with the full data for each service: id, name, color, disabled, archived, translations and appointment settings.

get_sms_rules

ChatGPT
Retrieves the SMS rules configured for a location. SMS rules send text notifications to visitors on appointment or ticket events (the rules shown on the location's SMS page). REQUIRED: - locationId: The location to read SMS rules from. RETURN VALUE: JSON with the full data for each rule: name, trigger, message, the lines it applies to, delay/leadTime, translations, plus the read-only updated timestamp and count of messages sent. Rules have no id and are managed as a single list for the location.

reorder_input_fields

ChatGPT
Sets the order in which a location's reorderable input fields are shown. REQUIRED: - locationId: The location whose input fields are being reordered. - inputFieldIds: The COMPLETE ordered list of the location's reorderable (custom) input-field ids (UUIDs), first to last. IMPORTANT — which fields to include: The base identity fields (first name, last name, email, phone number) always come first in a fixed order and CANNOT be reordered — do not include them. Include every other (custom) field of the location: any reorderable field you leave out is pushed to the end with undefined ordering. Call get_input_fields first, take all fields except the base ones, and send them back in the order you want. The list must contain exactly the location's reorderable fields — no duplicates, no base fields, no ids from other locations. RETURN VALUE: JSON with the applied order, e.g. { "orderedInputFieldIds": ["...", "..."] }.

reorder_services

ChatGPT
Sets the order in which a location's services are shown. REQUIRED: - locationId: The location whose services are being reordered. - serviceIds: The COMPLETE ordered list of the location's service ids, first to last. IMPORTANT — which services to include: The list must contain every service of the location, including archived ones — no duplicates, no unknown ids, none left out. Call get_services with includeArchived: true first to get the full list, then send the ids back in the order you want. RETURN VALUE: JSON with the applied order, e.g. { "orderedServiceIds": [3, 1, 2] }.

save_sms_rules

ChatGPT
Saves the SMS rules for a location. SMS rules send text notifications to visitors on appointment or ticket events (the rules on the location's SMS page). This REPLACES the location's entire set of SMS rules with the list you provide. Any existing rule you do NOT include is DELETED. Always call get_sms_rules first, then send back the full list with your additions/edits applied. Passing an empty list removes all rules. REQUIRED: - locationId: The location whose SMS rules are saved. - rules: The COMPLETE list of rules the location should have. Each rule has: - name (required) - trigger (required): one of APPOINTMENT_CANCELLED_BY_CLERK, APPOINTMENT_CREATED, APPOINTMENT_NOSHOW, APPOINTMENT_REMINDER, APPOINTMENT_RESCHEDULED, TICKET_CREATED, TICKET_CALLED, TICKET_CALLED_DESK, TICKET_SERVED, TICKET_CALLED_SOON - message (required): the SMS body, 1 to 1000 characters - lines (optional): line ids the rule applies to; omit for all lines - leadTime (optional): for APPOINTMENT_REMINDER — how long before the appointment to send. One of THREE_DAYS_BEFORE, TWO_DAYS_BEFORE, ONE_DAY_BEFORE, TWO_HOURS_BEFORE, ONE_HOUR_BEFORE - delay (optional): for TICKET_SERVED — how long after the event to send. One of NONE, ONE_HOUR, DAY - translations (optional): per-language messages, each with a languageCode and message RETURN VALUE: JSON confirming the save, e.g. { "status": "saved", "ruleCount": 3 }.

Capabilities

Writes

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/qminder"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/qminder)