Home / Servers / Square API / list_bookings
ListBookings
An MCP tool from the Square API server, hosted on mcp.hjlabs.in.
ListBookings Retrieve a collection of bookings. To call this endpoint with buyer-level permissions, set APPOINTMENTS_READ for the OAuth scope. To call this endpoint with seller-level permissions, set… [GET /v2/bookings]
Name on the gateway: square_api__list_bookings · read-only.
Parameters
| Name | Type | Description |
|---|---|---|
limit | integer | The maximum number of results per page to return in a paged response. |
cursor | string | The pagination cursor from the preceding response to return the next page of… |
customer_id | string | The customer for whom to retrieve bookings. If this is not set, bookings for… |
team_member_id | string | The team member for whom to retrieve bookings. If this is not set, bookings of… |
location_id | string | The location for which to retrieve bookings. If this is not set, all… |
start_at_min | string | The RFC 3339 timestamp specifying the earliest of the start time. If this is… |
start_at_max | string | The RFC 3339 timestamp specifying the latest of the start time. If this is not… |
How to call it
Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:
{
"name": "square_api__list_bookings",
"arguments": {}
}Or connect the Square API server directly, which lists 308 tools including this one:
claude mcp add --transport http hj-square-api https://mcp.hjlabs.in/mcp/square-api \
--header "Authorization: Bearer YOUR_API_KEY"Try asking
Use the listbookings tool with limit set to ….