Appntmnts MCP by usefulapi
Read event types, open slots and bookings; create and cancel bookings in Appntmnts.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"appntmnts": {
"url": "https://appntmnts.usefulapi.io/mcp"
}
}
}Remote endpoints
https://appntmnts.usefulapi.io/mcpstreamable-httpWhat it can do
Tool inventory
Tools (9)
🟢appntmnts_whoami
Return the Appntmnts account the API key belongs to: name, username, timezone and public booking URL. Good first call to confirm the connection. Appntmnts API: GET /api/v1/me.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢appntmnts_list_event_types(active_only)
List the event types (meeting templates) on the account, with duration, kind, price and public booking URL. Use the id or slug from here in the other tools. Appntmnts API: GET /api/v1/event-types.
Input Schema
{
"type": "object",
"properties": {
"active_only": {
"description": "When true, return only active event types.",
"type": "boolean"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢appntmnts_get_event_type(event_type)
Get one event type by numeric id or slug, including duration, location and whether payment is required. Appntmnts API: GET /api/v1/event-types/{idOrSlug}.
Input Schema
{
"type": "object",
"properties": {
"event_type": {
"type": "string",
"minLength": 1,
"description": "Event type id (e.g. 12) or slug (e.g. 30min)."
}
},
"required": [
"event_type"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢appntmnts_get_slots(event_type, date)
List the open start times for one event type on one date, honoring its schedule, buffers and existing bookings. Appntmnts API: GET /api/v1/event-types/{idOrSlug}/slots.
Input Schema
{
"type": "object",
"properties": {
"event_type": {
"type": "string",
"minLength": 1,
"description": "Event type id (e.g. 12) or slug (e.g. 30min)."
},
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "The day to check (yyyy-mm-dd), today or later."
}
},
"required": [
"event_type",
"date"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢appntmnts_list_availability(event_type, from, days)
List open start times for one event type across up to 31 days. Days with no availability are omitted. Appntmnts API: GET /api/v1/availability.
Input Schema
{
"type": "object",
"properties": {
"event_type": {
"type": "string",
"minLength": 1,
"description": "Event type id (e.g. 12) or slug (e.g. 30min)."
},
"from": {
"description": "First day of the range (yyyy-mm-dd). Defaults to today.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"days": {
"description": "How many days to scan (1-31, default 7).",
"type": "integer",
"minimum": 1,
"maximum": 31
}
},
"required": [
"event_type"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢appntmnts_list_bookings(status, from, to, event_type, per_page)
List bookings, most recent first, with optional filters for status, date range and event type. Returns one page plus meta (current_page, last_page, total). Appntmnts API: GET /api/v1/bookings.
Input Schema
{
"type": "object",
"properties": {
"status": {
"description": "Only bookings with this status.",
"type": "string",
"enum": [
"pending",
"confirmed",
"cancelled",
"completed",
"no_show"
]
},
"from": {
"description": "Only bookings on or after this date (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"to": {
"description": "Only bookings on or before this date (yyyy-mm-dd).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"event_type": {
"description": "Only bookings of this event type (id or slug).",
"type": "string"
},
"per_page": {
"description": "Results per page (1-100, default 25).",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢appntmnts_get_booking(booking_id)
Get one booking by id: status, payment status, customer, scheduled time and meeting URL. Appntmnts API: GET /api/v1/bookings/{id}.
Input Schema
{
"type": "object",
"properties": {
"booking_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The booking id (from appntmnts_list_bookings)."
}
},
"required": [
"booking_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴appntmnts_create_booking(event_type, customer_name, customer_email, customer_phone, scheduled_date, ...)
Book one open slot for an attendee. The slot must match an open start time from appntmnts_get_slots; otherwise the call fails with HTTP 422. This sends the attendee a confirmation. It is not idempotent: a retry can create a second booking. Appntmnts API: POST /api/v1/bookings.
Input Schema
{
"type": "object",
"properties": {
"event_type": {
"type": "string",
"minLength": 1,
"description": "Event type id (e.g. 12) or slug (e.g. 30min)."
},
"customer_name": {
"type": "string",
"minLength": 1,
"description": "The attendee name."
},
"customer_email": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"description": "The attendee e-mail address."
},
"customer_phone": {
"description": "Optional attendee phone number.",
"type": "string"
},
"scheduled_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Booking day (yyyy-mm-dd), today or later."
},
"scheduled_time_start": {
"type": "string",
"pattern": "^\\d{2}:\\d{2}$",
"description": "Start time (HH:MM), must match an open slot."
},
"notes": {
"description": "Optional note for the booking (max 1000 characters).",
"type": "string",
"maxLength": 1000
}
},
"required": [
"event_type",
"customer_name",
"customer_email",
"scheduled_date",
"scheduled_time_start"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴appntmnts_cancel_booking(booking_id, reason)
Cancel a pending or confirmed booking by id. This sends the normal cancellation e-mails and triggers the account's workflows. It cannot be undone through this API. Appntmnts API: POST /api/v1/bookings/{id}/cancel.
Input Schema
{
"type": "object",
"properties": {
"booking_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The booking id to cancel (from appntmnts_list_bookings)."
},
"reason": {
"description": "Optional cancellation reason (max 500 characters).",
"type": "string",
"maxLength": 500
}
},
"required": [
"booking_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Evidence