Appntmnts MCP by usefulapi

Read event types, open slots and bookings; create and cancel bookings in Appntmnts.

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
90%
Naming quality
80%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~1,739Tokens (tool definitions)
~1.2 KBTypical response size
Moderate attention impact (1.36% of 128k context)

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-http

What it can do

Tool inventory

Tools (9)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢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

Rate this Server

Evidence

Recent observations

verifiedversion not recorded9 tools