Skip to main content
Glama

YouCanBook.me MCP by usefulapi

List bookings

list_bookings
Read-only

List bookings (appointments) on the YouCanBookMe account. YCBM API: GET /v1/bookings. Filter by profileId (booking page), an after/before time window, cancelled status, and a free-text searchText; select fields with fields. Paginated via page (0-based) + maxResults. Returns a JSON array of bookings.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
pageNoPagination page number, 0-based (offset-based paging). Use with maxResults.
afterNoOnly bookings starting AFTER this time (ISO 8601, e.g. 2026-07-01T00:00:00Z).
beforeNoOnly bookings starting BEFORE this time (ISO 8601).
fieldsNoComma-separated field paths to return (e.g. "id,title,startsAt"). Supports dotted paths for nested objects. Omit to get the default field set.
paramsNoAdditional documented query-string filters to send verbatim (merged with the typed params above).
cancelledNoFilter by cancelled status: true = only cancelled, false = only active. Omit for all.
profileIdNoRestrict to bookings on this profile (booking page) id.
maxResultsNoMaximum records per page (page size). Defaults to the API's own default when omitted.
searchTextNoFree-text search across booking fields (e.g. attendee name/email).

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • changedInput schema / $schema
      Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • removedInput schema / properties / params / additionalProperties / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "boolean"
      -  }
      -]
    • addedInput schema / properties / params / additionalProperties / type
      Added value: +[
      +  "string",
      +  "number",
      +  "boolean"
      +]
  2. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.