Appointedd MCP by usefulapi is an MCP server published by io.usefulapi, hosted at appointedd.usefulapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 20 tools, including appointedd_list_bookings, appointedd_list_customers, appointedd_get_customer, appointedd_list_resources, appointedd_list_resource_groups.
Read Appointedd bookings, customers and availability; create, change and cancel bookings.
4,064 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
List bookings, newest first by default. Filter by time window (after/before), customer, service, resource, category, status or creation/update time. Each booking has its service, resource, start/end, status and the customers on it (with their notes, questions and statuses). Page with `next`. GET /bookings.
| Parameter | Type | Description |
|---|---|---|
| end | string | Page cursor: pass the previous reply's `prev` to get the preceding page. |
| ids | array | Only bookings with one of these ids. |
| after | string | Only bookings that start at or after this date-time. |
| limit | integer | Results per page, 1-100 (default 25). |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
| start | string | Page cursor: pass the previous reply's `next` to get the following page. |
| before | string | Only bookings that end at or before this date-time. |
| sort_by | string | Sort property (default natural). |
| order_by | string | Sort direction (the API default is desc). |
| services | array | Only bookings of services with one of these ids. |
| statuses | array | Only bookings with one of these statuses. |
| timezone | string | IANA time zone for the dates and times in the reply, e.g. Europe/London (default UTC). |
| customers | array | Only bookings for customers with one of these ids. |
| resources | array | Only bookings of resources with one of these ids. |
| categories | array | Only bookings of service categories with one of these ids. |
| created_after | string | ISO 8601 date-time, e.g. 2026-11-02T09:00:00Z (a date-time without an offset is read in UTC unless a timezone is given). |
| updated_after | string | ISO 8601 date-time, e.g. 2026-11-02T09:00:00Z (a date-time without an offset is read in UTC unless a timezone is given). |
| created_before | string | ISO 8601 date-time, e.g. 2026-11-02T09:00:00Z (a date-time without an offset is read in UTC unless a timezone is given). |
| updated_before | string | ISO 8601 date-time, e.g. 2026-11-02T09:00:00Z (a date-time without an offset is read in UTC unless a timezone is given). |
{
"name": "appointedd_list_bookings",
"title": "List bookings",
"description": "List bookings, newest first by default. Filter by time window (after/before), customer, service, resource, category, status or creation/update time. Each booking has its service, resource, start/end, status and the customers on it (with their notes, questions and statuses). Page with `next`. GET /bookings.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"end": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Page cursor: pass the previous reply's `prev` to get the preceding page."
},
"ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"maxItems": 100,
"description": "Only bookings with one of these ids."
},
"after": {
"type": "string",
"description": "Only bookings that start at or after this date-time."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100 (default 25)."
},
"start": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Page cursor: pass the previous reply's `next` to get the following page."
},
"before": {
"type": "string",
"description": "Only bookings that end at or before this date-time."
},
"sort_by": {
"enum": [
"natural",
"creation",
"updated",
"start"
],
"type": "string",
"description": "Sort property (default natural)."
},
"order_by": {
"enum": [
"asc",
"desc"
],
"type": "string",
"description": "Sort direction (the API default is desc)."
},
"services": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"maxItems": 100,
"description": "Only bookings of services with one of these ids."
},
"statuses": {
"type": "array",
"items": {
"enum": [
"confirmed",
"declined",
"cancelled",
"pending"
],
"type": "string"
},
"maxItems": 4,
"description": "Only bookings with one of these statuses."
},
"timezone": {
"type": "string",
"description": "IANA time zone for the dates and times in the reply, e.g. Europe/London (default UTC)."
},
"customers": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"maxItems": 100,
"description": "Only bookings for customers with one of these ids."
},
"resources": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"maxItems": 100,
"description": "Only bookings of resources with one of these ids."
},
"categories": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"maxItems": 100,
"description": "Only bookings of service categories with one of these ids."
},
"created_after": {
"type": "string",
"description": "ISO 8601 date-time, e.g. 2026-11-02T09:00:00Z (a date-time without an offset is read in UTC unless a timezone is given)."
},
"updated_after": {
"type": "string",
"description": "ISO 8601 date-time, e.g. 2026-11-02T09:00:00Z (a date-time without an offset is read in UTC unless a timezone is given)."
},
"created_before": {
"type": "string",
"description": "ISO 8601 date-time, e.g. 2026-11-02T09:00:00Z (a date-time without an offset is read in UTC unless a timezone is given)."
},
"updated_before": {
"type": "string",
"description": "ISO 8601 date-time, e.g. 2026-11-02T09:00:00Z (a date-time without an offset is read in UTC unless a timezone is given)."
}
}
},
"annotations": {
"title": "List bookings",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List customers in the CRM: name, email, phone/mobile, address, tags, custom fields, marketing opt-in. Page with `next`. GET /customers.
| Parameter | Type | Description |
|---|---|---|
| end | string | Page cursor: pass the previous reply's `prev` to get the preceding page. |
| ids | array | Only customers with one of these ids. |
| limit | integer | Results per page, 1-100 (default 25). |
| start | string | Page cursor: pass the previous reply's `next` to get the following page. |
| sort_by | string | Sort property (default natural). |
| order_by | string | Sort direction (the API default is desc). |
{
"name": "appointedd_list_customers",
"title": "List customers",
"description": "List customers in the CRM: name, email, phone/mobile, address, tags, custom fields, marketing opt-in. Page with `next`. GET /customers.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"end": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Page cursor: pass the previous reply's `prev` to get the preceding page."
},
"ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"maxItems": 100,
"description": "Only customers with one of these ids."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100 (default 25)."
},
"start": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Page cursor: pass the previous reply's `next` to get the following page."
},
"sort_by": {
"enum": [
"natural",
"created",
"profile.firstname",
"profile.lastname"
],
"type": "string",
"description": "Sort property (default natural)."
},
"order_by": {
"enum": [
"asc",
"desc"
],
"type": "string",
"description": "Sort direction (the API default is desc)."
}
}
},
"annotations": {
"title": "List customers",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One customer by id. GET /customers/{customer_id}.
| Parameter | Type | Description |
|---|---|---|
| customer_id * | string | Appointedd id (24-character hex string). |
{
"name": "appointedd_get_customer",
"title": "Get customer",
"description": "One customer by id. GET /customers/{customer_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"customer_id"
],
"properties": {
"customer_id": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Appointedd id (24-character hex string)."
}
}
},
"annotations": {
"title": "Get customer",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List resources (the staff members, rooms or equipment that bookings are made for): name, assigned service ids and resource group ids. Page with `next`. GET /resources.
| Parameter | Type | Description |
|---|---|---|
| end | string | Page cursor: pass the previous reply's `prev` to get the preceding page. |
| ids | array | Only resources with one of these ids. |
| limit | integer | Results per page, 1-100 (default 25). |
| start | string | Page cursor: pass the previous reply's `next` to get the following page. |
| sort_by | string | one of ["natural","creation"] |
| order_by | string | Sort direction (the API default is desc). |
| services | array | Only resources assigned to services with one of these ids. |
{
"name": "appointedd_list_resources",
"title": "List resources",
"description": "List resources (the staff members, rooms or equipment that bookings are made for): name, assigned service ids and resource group ids. Page with `next`. GET /resources.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"end": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Page cursor: pass the previous reply's `prev` to get the preceding page."
},
"ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"maxItems": 100,
"description": "Only resources with one of these ids."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100 (default 25)."
},
"start": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Page cursor: pass the previous reply's `next` to get the following page."
},
"sort_by": {
"enum": [
"natural",
"creation"
],
"type": "string"
},
"order_by": {
"enum": [
"asc",
"desc"
],
"type": "string",
"description": "Sort direction (the API default is desc)."
},
"services": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"maxItems": 100,
"description": "Only resources assigned to services with one of these ids."
}
}
},
"annotations": {
"title": "List resources",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List resource groups (id and name). Page with `next`. GET /resources/groups.
| Parameter | Type | Description |
|---|---|---|
| end | string | Page cursor: pass the previous reply's `prev` to get the preceding page. |
| ids | array | Only resource groups with one of these ids. |
| limit | integer | Results per page, 1-100 (default 25). |
| start | string | Page cursor: pass the previous reply's `next` to get the following page. |
| order_by | string | Sort direction (the API default is desc). |
{
"name": "appointedd_list_resource_groups",
"title": "List resource groups",
"description": "List resource groups (id and name). Page with `next`. GET /resources/groups.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"end": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Page cursor: pass the previous reply's `prev` to get the preceding page."
},
"ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"maxItems": 100,
"description": "Only resource groups with one of these ids."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100 (default 25)."
},
"start": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Page cursor: pass the previous reply's `next` to get the following page."
},
"order_by": {
"enum": [
"asc",
"desc"
],
"type": "string",
"description": "Sort direction (the API default is desc)."
}
}
},
"annotations": {
"title": "List resource groups",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List services (what can be booked): name, category, durations and prices, buffers, occupancy and booking type. Page with `next`. GET /services.
| Parameter | Type | Description |
|---|---|---|
| end | string | Page cursor: pass the previous reply's `prev` to get the preceding page. |
| ids | array | Only services with one of these ids. |
| limit | integer | Results per page, 1-100 (default 25). |
| start | string | Page cursor: pass the previous reply's `next` to get the following page. |
{
"name": "appointedd_list_services",
"title": "List services",
"description": "List services (what can be booked): name, category, durations and prices, buffers, occupancy and booking type. Page with `next`. GET /services.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"end": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Page cursor: pass the previous reply's `prev` to get the preceding page."
},
"ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"maxItems": 100,
"description": "Only services with one of these ids."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100 (default 25)."
},
"start": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Page cursor: pass the previous reply's `next` to get the following page."
}
}
},
"annotations": {
"title": "List services",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One service by id, including its booking questions, durations, prices and buffers. GET /services/{service_id}.
| Parameter | Type | Description |
|---|---|---|
| service_id * | string | Appointedd id (24-character hex string). |
{
"name": "appointedd_get_service",
"title": "Get service",
"description": "One service by id, including its booking questions, durations, prices and buffers. GET /services/{service_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"service_id"
],
"properties": {
"service_id": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Appointedd id (24-character hex string)."
}
}
},
"annotations": {
"title": "Get service",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List service categories (id and name). Page with `next`. GET /services/categories.
| Parameter | Type | Description |
|---|---|---|
| end | string | Page cursor: pass the previous reply's `prev` to get the preceding page. |
| ids | array | Only service categories with one of these ids. |
| limit | integer | Results per page, 1-100 (default 25). |
| start | string | Page cursor: pass the previous reply's `next` to get the following page. |
{
"name": "appointedd_list_service_categories",
"title": "List service categories",
"description": "List service categories (id and name). Page with `next`. GET /services/categories.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"end": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Page cursor: pass the previous reply's `prev` to get the preceding page."
},
"ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"maxItems": 100,
"description": "Only service categories with one of these ids."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100 (default 25)."
},
"start": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Page cursor: pass the previous reply's `next` to get the following page."
}
}
},
"annotations": {
"title": "List service categories",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One service category by id. GET /services/categories/{category_id}.
| Parameter | Type | Description |
|---|---|---|
| category_id * | string | Appointedd id (24-character hex string). |
{
"name": "appointedd_get_service_category",
"title": "Get service category",
"description": "One service category by id. GET /services/categories/{category_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"category_id"
],
"properties": {
"category_id": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Appointedd id (24-character hex string)."
}
}
},
"annotations": {
"title": "Get service category",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Find the start times at which a service can be booked in the given ranges, with the free resource ids for each (and existing group bookings with room). Step 1 of making a booking: pick a start, then appointedd_create_reservation. Read-only. POST /availability/intervals/search.
| Parameter | Type | Description |
|---|---|---|
| ranges * | array | One or more date-time ranges to search, e.g. [{start, end}]. |
| spaces | integer | Spaces needed (excludes group bookings with too few spaces). Default 1. |
| duration | integer | Continuous minutes that must be free. Default: the service's default duration. |
| timezone | string | IANA time zone for range times without an offset and for the reply. Default UTC. |
| service_id * | string | Service the booking would be for (use appointedd_list_services). |
| resource_ids | array | Resources (staff, rooms) to check. Default: all resources assigned to the service. Not together with resource_group_ids. |
| resource_group_ids | array | Resource groups whose resources to check. Not together with resource_ids. |
| ignore_service_schedule | boolean | Ignore the service's schedule. |
| ignore_notice_restriction | boolean | Ignore the organisation's/service's notice period. |
{
"name": "appointedd_find_available_intervals",
"title": "Find available times",
"description": "Find the start times at which a service can be booked in the given ranges, with the free resource ids for each (and existing group bookings with room). Step 1 of making a booking: pick a start, then appointedd_create_reservation. Read-only. POST /availability/intervals/search.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"ranges",
"service_id"
],
"properties": {
"ranges": {
"type": "array",
"items": {
"type": "object",
"required": [
"start",
"end"
],
"properties": {
"end": {
"type": "string",
"description": "ISO 8601 date-time, e.g. 2026-11-02T09:00:00Z (a date-time without an offset is read in UTC unless a timezone is given)."
},
"start": {
"type": "string",
"description": "ISO 8601 date-time, e.g. 2026-11-02T09:00:00Z (a date-time without an offset is read in UTC unless a timezone is given)."
}
}
},
"maxItems": 20,
"minItems": 1,
"description": "One or more date-time ranges to search, e.g. [{start, end}]."
},
"spaces": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Spaces needed (excludes group bookings with too few spaces). Default 1."
},
"duration": {
"type": "integer",
"maximum": 100000,
"minimum": 1,
"description": "Continuous minutes that must be free. Default: the service's default duration."
},
"timezone": {
"type": "string",
"description": "IANA time zone for range times without an offset and for the reply. Default UTC."
},
"service_id": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Service the booking would be for (use appointedd_list_services)."
},
"resource_ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Appointedd id (24-character hex string)."
},
"maxItems": 100,
"description": "Resources (staff, rooms) to check. Default: all resources assigned to the service. Not together with resource_group_ids."
},
"resource_group_ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Appointedd id (24-character hex string)."
},
"maxItems": 100,
"description": "Resource groups whose resources to check. Not together with resource_ids."
},
"ignore_service_schedule": {
"type": "boolean",
"description": "Ignore the service's schedule."
},
"ignore_notice_restriction": {
"type": "boolean",
"description": "Ignore the organisation's/service's notice period."
}
}
},
"annotations": {
"title": "Find available times",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Find which days in the given ranges have any availability for a service (a calendar view; use appointedd_find_available_intervals for the times). Read-only. POST /availability/days/search.
| Parameter | Type | Description |
|---|---|---|
| ranges * | array | One or more date-time ranges to search, e.g. [{start, end}]. |
| spaces | integer | Spaces needed (excludes group bookings with too few spaces). Default 1. |
| duration | integer | Continuous minutes that must be free. Default: the service's default duration. |
| timezone | string | IANA time zone for range times without an offset and for the reply. Default UTC. |
| service_id * | string | Service the booking would be for (use appointedd_list_services). |
| resource_ids | array | Resources (staff, rooms) to check. Default: all resources assigned to the service. Not together with resource_group_ids. |
| resource_group_ids | array | Resource groups whose resources to check. Not together with resource_ids. |
| ignore_service_schedule | boolean | Ignore the service's schedule. |
| ignore_notice_restriction | boolean | Ignore the organisation's/service's notice period. |
{
"name": "appointedd_find_available_dates",
"title": "Find available days",
"description": "Find which days in the given ranges have any availability for a service (a calendar view; use appointedd_find_available_intervals for the times). Read-only. POST /availability/days/search.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"ranges",
"service_id"
],
"properties": {
"ranges": {
"type": "array",
"items": {
"type": "object",
"required": [
"start",
"end"
],
"properties": {
"end": {
"type": "string",
"description": "ISO 8601 date-time, e.g. 2026-11-02T09:00:00Z (a date-time without an offset is read in UTC unless a timezone is given)."
},
"start": {
"type": "string",
"description": "ISO 8601 date-time, e.g. 2026-11-02T09:00:00Z (a date-time without an offset is read in UTC unless a timezone is given)."
}
}
},
"maxItems": 20,
"minItems": 1,
"description": "One or more date-time ranges to search, e.g. [{start, end}]."
},
"spaces": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Spaces needed (excludes group bookings with too few spaces). Default 1."
},
"duration": {
"type": "integer",
"maximum": 100000,
"minimum": 1,
"description": "Continuous minutes that must be free. Default: the service's default duration."
},
"timezone": {
"type": "string",
"description": "IANA time zone for range times without an offset and for the reply. Default UTC."
},
"service_id": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Service the booking would be for (use appointedd_list_services)."
},
"resource_ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Appointedd id (24-character hex string)."
},
"maxItems": 100,
"description": "Resources (staff, rooms) to check. Default: all resources assigned to the service. Not together with resource_group_ids."
},
"resource_group_ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Appointedd id (24-character hex string)."
},
"maxItems": 100,
"description": "Resource groups whose resources to check. Not together with resource_ids."
},
"ignore_service_schedule": {
"type": "boolean",
"description": "Ignore the service's schedule."
},
"ignore_notice_restriction": {
"type": "boolean",
"description": "Ignore the organisation's/service's notice period."
}
}
},
"annotations": {
"title": "Find available days",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One reservation (availability slot) by id: its service, resource, times and expiry. GET /availability/slots/{reservation_id}.
| Parameter | Type | Description |
|---|---|---|
| timezone | string | IANA time zone for the dates and times in the reply, e.g. Europe/London (default UTC). |
| reservation_id * | string | Appointedd id (24-character hex string). |
{
"name": "appointedd_get_reservation",
"title": "Get reservation",
"description": "One reservation (availability slot) by id: its service, resource, times and expiry. GET /availability/slots/{reservation_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"reservation_id"
],
"properties": {
"timezone": {
"type": "string",
"description": "IANA time zone for the dates and times in the reply, e.g. Europe/London (default UTC)."
},
"reservation_id": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Appointedd id (24-character hex string)."
}
}
},
"annotations": {
"title": "Get reservation",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}WRITE: create a customer in the CRM (first and last name required; email, mobile, phone, tags optional). POST /customers.
| Parameter | Type | Description |
|---|---|---|
| tags | array | Tags to put on the customer. |
| string | ||
| phone | string | |
| mobile | string | |
| lastname * | string | Last name. |
| firstname * | string | First name. |
{
"name": "appointedd_create_customer",
"title": "Create customer",
"description": "WRITE: create a customer in the CRM (first and last name required; email, mobile, phone, tags optional). POST /customers.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"firstname",
"lastname"
],
"properties": {
"tags": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"maxItems": 50,
"description": "Tags to put on the customer."
},
"email": {
"type": "string",
"maxLength": 320
},
"phone": {
"type": "string",
"maxLength": 40
},
"mobile": {
"type": "string",
"maxLength": 40
},
"lastname": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Last name."
},
"firstname": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "First name."
}
}
},
"annotations": {
"title": "Create customer",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}WRITE: change a customer's name, email, mobile, phone or tags. Only the fields you pass are sent; `tags` replaces the customer's tag list. PUT /customers/{customer_id}.
| Parameter | Type | Description |
|---|---|---|
| tags | array | New tag list (replaces the old one). |
| string | ||
| phone | string | |
| mobile | string | |
| lastname | string | |
| firstname | string | |
| customer_id * | string | Appointedd id (24-character hex string). |
{
"name": "appointedd_update_customer",
"title": "Update customer",
"description": "WRITE: change a customer's name, email, mobile, phone or tags. Only the fields you pass are sent; `tags` replaces the customer's tag list. PUT /customers/{customer_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"customer_id"
],
"properties": {
"tags": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"maxItems": 50,
"description": "New tag list (replaces the old one)."
},
"email": {
"type": "string",
"maxLength": 320
},
"phone": {
"type": "string",
"maxLength": 40
},
"mobile": {
"type": "string",
"maxLength": 40
},
"lastname": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"firstname": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"customer_id": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Appointedd id (24-character hex string)."
}
}
},
"annotations": {
"title": "Update customer",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}WRITE: hold a date and time for a booking (step 2). The reservation blocks that slot for `expires_after` minutes (default: the organisation's setting); then call appointedd_create_booking with the returned reservation id. Without resource_id a free resource assigned to the service is picked. POST /availability/slots.
| Parameter | Type | Description |
|---|---|---|
| start * | string | Start date-time, normally a `start` returned by appointedd_find_available_intervals. |
| duration | integer | Booking length in minutes; pass the same `duration` you searched with. Default: the service's default duration. |
| timezone | string | IANA time zone of `start` (when it has no offset) and of the reply. Default UTC. |
| service_id * | string | Appointedd id (24-character hex string). |
| resource_id | string | Resource to book. Default: any free resource of the service. |
| expires_after | integer | Minutes until the hold expires. |
| required_spaces | integer | Spaces needed (default 1). |
| resource_group_ids | array | Restrict the automatic resource choice to these groups. |
| ignore_service_schedule | boolean | Ignore the service's schedule; set it if you searched with it. |
| ignore_notice_restriction | boolean | Ignore the notice period; set it if you searched with it. |
{
"name": "appointedd_create_reservation",
"title": "Create reservation (hold a time)",
"description": "WRITE: hold a date and time for a booking (step 2). The reservation blocks that slot for `expires_after` minutes (default: the organisation's setting); then call appointedd_create_booking with the returned reservation id. Without resource_id a free resource assigned to the service is picked. POST /availability/slots.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"service_id",
"start"
],
"properties": {
"start": {
"type": "string",
"description": "Start date-time, normally a `start` returned by appointedd_find_available_intervals."
},
"duration": {
"type": "integer",
"maximum": 100000,
"minimum": 1,
"description": "Booking length in minutes; pass the same `duration` you searched with. Default: the service's default duration."
},
"timezone": {
"type": "string",
"description": "IANA time zone of `start` (when it has no offset) and of the reply. Default UTC."
},
"service_id": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Appointedd id (24-character hex string)."
},
"resource_id": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Resource to book. Default: any free resource of the service."
},
"expires_after": {
"type": "integer",
"maximum": 1440,
"minimum": 1,
"description": "Minutes until the hold expires."
},
"required_spaces": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Spaces needed (default 1)."
},
"resource_group_ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Appointedd id (24-character hex string)."
},
"maxItems": 100,
"description": "Restrict the automatic resource choice to these groups."
},
"ignore_service_schedule": {
"type": "boolean",
"description": "Ignore the service's schedule; set it if you searched with it."
},
"ignore_notice_restriction": {
"type": "boolean",
"description": "Ignore the notice period; set it if you searched with it."
}
}
},
"annotations": {
"title": "Create reservation",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}WRITE: turn an active reservation into a booking (step 3) for one or more customers; Appointedd matches each customer to the CRM by name/email/mobile or creates it. Payment requests are NOT sent unless send_payment_request is true. With an empty customers list an empty booking is created. POST /bookings.
| Parameter | Type | Description |
|---|---|---|
| label | string | Label shown on the booking in the appointment screen. |
| timezone | string | IANA time zone for the dates and times in the reply, e.g. Europe/London (default UTC). |
| customers * | array | Customers to add; [] for an empty booking. |
| reservation_id * | string | Id returned by appointedd_create_reservation (must not have expired). |
| send_payment_request | boolean | Send each customer a payment request (default false here; the API's own default is true). |
{
"name": "appointedd_create_booking",
"title": "Create booking",
"description": "WRITE: turn an active reservation into a booking (step 3) for one or more customers; Appointedd matches each customer to the CRM by name/email/mobile or creates it. Payment requests are NOT sent unless send_payment_request is true. With an empty customers list an empty booking is created. POST /bookings.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"reservation_id",
"customers"
],
"properties": {
"label": {
"type": "string",
"maxLength": 500,
"description": "Label shown on the booking in the appointment screen."
},
"timezone": {
"type": "string",
"description": "IANA time zone for the dates and times in the reply, e.g. Europe/London (default UTC)."
},
"customers": {
"type": "array",
"items": {
"type": "object",
"required": [
"profile"
],
"properties": {
"notes": {
"type": "string",
"maxLength": 5000,
"description": "Free-form notes for this customer on the booking."
},
"status": {
"enum": [
"Arrived",
"Complete",
"No Show",
"No Status"
],
"type": "string"
},
"profile": {
"type": "object",
"required": [
"firstname",
"lastname"
],
"properties": {
"email": {
"type": "string",
"maxLength": 320
},
"mobile": {
"type": "string",
"maxLength": 40
},
"lastname": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Last name."
},
"firstname": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "First name."
}
}
},
"total_spaces": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Spaces this customer uses (default 1)."
},
"marketing_subscribed": {
"type": "boolean",
"description": "Customer agreed to marketing emails (default false)."
}
}
},
"maxItems": 50,
"description": "Customers to add; [] for an empty booking."
},
"reservation_id": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Id returned by appointedd_create_reservation (must not have expired)."
},
"send_payment_request": {
"type": "boolean",
"description": "Send each customer a payment request (default false here; the API's own default is true)."
}
}
},
"annotations": {
"title": "Create booking",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}WRITE: change a booking's service, resource, label or total spaces, or move it by giving `parts` with new start/end times. Customers are NOT emailed unless send_notifications is true. PUT /bookings/{booking_id}.
| Parameter | Type | Description |
|---|---|---|
| label | string | |
| parts | array | New time parts of the booking (start/end); an availability check runs when moving. |
| timezone | string | IANA time zone for the dates and times in the reply, e.g. Europe/London (default UTC). |
| booking_id * | string | Appointedd id (24-character hex string). |
| service_id | string | Move the booking to this service. |
| resource_id | string | Assign the booking to this resource. |
| total_spaces | integer | |
| send_notifications | boolean | Email each customer that the booking changed (default false here; the API's own default is true). |
| ignore_service_schedule | boolean | Allow moving outside the service's schedule. |
{
"name": "appointedd_update_booking",
"title": "Update booking",
"description": "WRITE: change a booking's service, resource, label or total spaces, or move it by giving `parts` with new start/end times. Customers are NOT emailed unless send_notifications is true. PUT /bookings/{booking_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"booking_id"
],
"properties": {
"label": {
"type": "string",
"maxLength": 500
},
"parts": {
"type": "array",
"items": {
"type": "object",
"required": [
"start",
"end"
],
"properties": {
"end": {
"type": "string",
"description": "ISO 8601 date-time with an offset, e.g. 2026-11-02T09:00:00Z."
},
"label": {
"type": "string",
"maxLength": 200
},
"start": {
"type": "string",
"description": "ISO 8601 date-time with an offset, e.g. 2026-11-02T09:00:00Z."
}
}
},
"maxItems": 20,
"minItems": 1,
"description": "New time parts of the booking (start/end); an availability check runs when moving."
},
"timezone": {
"type": "string",
"description": "IANA time zone for the dates and times in the reply, e.g. Europe/London (default UTC)."
},
"booking_id": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Appointedd id (24-character hex string)."
},
"service_id": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Move the booking to this service."
},
"resource_id": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Assign the booking to this resource."
},
"total_spaces": {
"type": "integer",
"maximum": 1000,
"minimum": 1
},
"send_notifications": {
"type": "boolean",
"description": "Email each customer that the booking changed (default false here; the API's own default is true)."
},
"ignore_service_schedule": {
"type": "boolean",
"description": "Allow moving outside the service's schedule."
}
}
},
"annotations": {
"title": "Update booking",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}WRITE: set the arrival status (Arrived, Complete, No Show, No Status) and/or notes of one customer on a booking. customer_booking_id is the customer's `customer_booking_id` (or `customer_id`) in the booking's customers list. PUT /bookings/{booking_id}/customers/{customer_booking_id}.
| Parameter | Type | Description |
|---|---|---|
| notes | string | Replaces the customer's notes on this booking. |
| status | string | one of ["Arrived","Complete","No Show","No Status"] |
| booking_id * | string | Appointedd id (24-character hex string). |
| customer_booking_id * | string | `customer_booking_id` (or `customer_id`) from the booking's customers list. |
{
"name": "appointedd_update_booking_customer",
"title": "Update customer on booking",
"description": "WRITE: set the arrival status (Arrived, Complete, No Show, No Status) and/or notes of one customer on a booking. customer_booking_id is the customer's `customer_booking_id` (or `customer_id`) in the booking's customers list. PUT /bookings/{booking_id}/customers/{customer_booking_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"booking_id",
"customer_booking_id"
],
"properties": {
"notes": {
"type": "string",
"maxLength": 5000,
"description": "Replaces the customer's notes on this booking."
},
"status": {
"enum": [
"Arrived",
"Complete",
"No Show",
"No Status"
],
"type": "string"
},
"booking_id": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Appointedd id (24-character hex string)."
},
"customer_booking_id": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "`customer_booking_id` (or `customer_id`) from the booking's customers list."
}
}
},
"annotations": {
"title": "Update customer on booking",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}WRITE (cannot be undone): cancel a whole booking. Appointedd may notify the customers according to the organisation's settings. To remove one customer from a group booking use appointedd_cancel_booking_customer. POST /bookings/{booking_id}/cancel.
| Parameter | Type | Description |
|---|---|---|
| booking_id * | string | Appointedd id (24-character hex string). |
{
"name": "appointedd_cancel_booking",
"title": "Cancel booking",
"description": "WRITE (cannot be undone): cancel a whole booking. Appointedd may notify the customers according to the organisation's settings. To remove one customer from a group booking use appointedd_cancel_booking_customer. POST /bookings/{booking_id}/cancel.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"booking_id"
],
"properties": {
"booking_id": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Appointedd id (24-character hex string)."
}
}
},
"annotations": {
"title": "Cancel booking",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}WRITE (cannot be undone): cancel one customer's place on a booking (the booking stays for the others). customer_booking_id is the `customer_booking_id` in the booking's customers list. POST /bookings/{booking_id}/customers/{customer_booking_id}/cancel.
| Parameter | Type | Description |
|---|---|---|
| booking_id * | string | Appointedd id (24-character hex string). |
| customer_booking_id * | string | `customer_booking_id` from the booking's customers list. |
{
"name": "appointedd_cancel_booking_customer",
"title": "Cancel customer on booking",
"description": "WRITE (cannot be undone): cancel one customer's place on a booking (the booking stays for the others). customer_booking_id is the `customer_booking_id` in the booking's customers list. POST /bookings/{booking_id}/customers/{customer_booking_id}/cancel.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"booking_id",
"customer_booking_id"
],
"properties": {
"booking_id": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Appointedd id (24-character hex string)."
},
"customer_booking_id": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "`customer_booking_id` from the booking's customers list."
}
}
},
"annotations": {
"title": "Cancel customer on booking",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Tools for Appointedd, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "What bookings do I have tomorrow, and who are the customers?"; "Find the next free 30-minute slot for a consultation with any resource this week."; "Book Ada Lovelace (ada@example.org) into the first free slot on Monday.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Appointedd data. Free plan: 50 tool calls per month. Run appointedd_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run appointedd_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run appointedd_upgrade without a plan: it returns both plans, each with a payment link for the user to open. appointedd_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.