Skip to content
MCP server

YouCanBook.me MCP by usefulapi

Manage YouCanBook.me bookings, booking pages, appointment types, team members and…

Install
Runs
Remotely
Version
1.42.0
Listing updated
4 days ago

About YouCanBook.me MCP by usefulapi

YouCanBook.me MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Manage YouCanBook.me bookings, booking pages, appointment types, team members and locations.

Install

Run in a terminal

claude mcp add --transport http youcanbookme https://youcanbookme.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://youcanbookme.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "youcanbookme": {
      "url": "https://youcanbookme.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "youcanbookme": {
      "type": "http",
      "url": "https://youcanbookme.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "youcanbookme": {
      "serverUrl": "https://youcanbookme.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "youcanbookme": {
      "type": "http",
      "url": "https://youcanbookme.usefulapi.io/mcp"
    }
  }
}

Tools this server provides (18)

Read directly from the server.

youcanbookme_list_bookings
List bookings on your account. Unfiltered reads use GET /v1/{accountId}/bookings (10 per page). Filtered reads use GET /v1/accounts/{accountId}/bookings/query: supply after as the required start of the time range; optionally before, profileId, cancelled, searchText and maxResults (10-500). Pagination uses cursors, not page numbers: params accepts direction plus boundaryStartsAt/boundaryId for unfi
youcanbookme_get_booking
Fetch a single booking (appointment) by id. YCBM API: GET /v1/bookings/{bookingId}. Use `fields` to select which fields to return. Returns the booking object.
youcanbookme_list_profiles
List all profiles (booking pages) on the account. YCBM API: GET /v1/profiles. A profile is a bookable page with its own subdomain, appointment types, team members, and locations. Use `fields` to select fields (e.g. "id,title,subdomain"). Paginated via page (0-based) + maxResults. Returns a JSON array of profiles.
youcanbookme_get_profile
Fetch a single profile (booking page) by id. YCBM API: GET /v1/profiles/{profileId}. Use `fields` to select fields, including nested sub-resources (appointmentTypes, teamMembers, locations). Returns the profile object.
youcanbookme_list_team_members
List the team members configured on a profile (booking page). YCBM API: GET /v1/profiles/{profileId} with a teamMembers field selection. Returns the profile's teamMembers block (each member has id, name, email, description, pic, calendarId).
youcanbookme_list_appointment_types
List the appointment types configured on a profile (booking page). YCBM API: GET /v1/profiles/{profileId} with an appointmentTypes field selection. Returns the profile's appointmentTypes block (each with id, name, description, slotLength, price).
youcanbookme_list_locations
List the locations configured on a profile (booking page). YCBM API: GET /v1/profiles/{profileId} with a locations field selection. Returns the profile's locations block (each with id, kind, value, notes, strategy).
youcanbookme_list_available_accounts
List the accounts/calendars available to your account — used to find the calendarId for a team member. YCBM API: GET /v1/{accountId}/availableAccounts (accountId is taken from your configured credentials). Returns a JSON array.
youcanbookme_request
Power-user escape hatch: GET any YCBM API path not wrapped by a dedicated tool. READ-ONLY — only GET is allowed. Pass the FULL API path after the origin, starting with a slash, INCLUDING any query string, e.g. "/v1/bookings?maxResults=5" or "/v1/profiles". Returns the parsed JSON.
youcanbookme_create_booking
MUTATES YouCanBookMe data: creates a booking (appointment) on a profile. YCBM API: POST /v1/bookings (JSON). Required: profileId, startsAt, endsAt (ISO 8601 times). Optional: title, timeZone, locale, units. Complex fields like `answers` (form-field answers) and `linkFields` should be passed via the `fields` passthrough. Returns the created booking.
youcanbookme_update_booking
MUTATES YouCanBookMe data: updates an existing booking (reschedule, rename, mark cancelled/no-show). YCBM API: PATCH /v1/bookings/{bookingId} (JSON, partial update). Set any of title/startsAt/endsAt/cancelled/noShow/timeZone/locale/units; use the `fields` passthrough for answers/linkFields or other documented fields. The path id is never sent in the body.
youcanbookme_cancel_booking
MUTATES YouCanBookMe data: cancels a booking. Convenience wrapper for PATCH /v1/bookings/{bookingId} with { cancelled: true } — safer and reversible (re-activate via youcanbookme_update_booking cancelled=false) versus deleting. Returns the updated booking.
youcanbookme_update_profile
MUTATES YouCanBookMe data: updates a profile's (booking page) configuration. YCBM API: PATCH /v1/profiles/{profileId} (JSON, partial update). Pass the fields to change via the `fields` passthrough (e.g. { title, subdomain, ... }) — profile fields are numerous and use YCBM's own names. The path id is never sent in the body.
youcanbookme_create_appointment_type
MUTATES YouCanBookMe data: adds an appointment type to a profile. YCBM API: POST /v1/profiles/{profileId}/appointmenttypes/items (JSON). Required: name; use the `fields` passthrough for description, slotLength, price, etc. The path profileId is never sent in the body.
youcanbookme_update_appointment_type
MUTATES YouCanBookMe data: updates an appointment type on a profile. YCBM API: PATCH /v1/profiles/{profileId}/appointmenttypes/items/{appointmentTypeId} (JSON, partial update). Pass changed fields (name, description, slotLength, price, ...) via the `fields` passthrough. Path ids are never sent in the body.
youcanbookme_create_team_member
MUTATES YouCanBookMe data: adds a team member to a profile. YCBM API: POST /v1/profiles/{profileId}/teammembers/items (JSON). Required: name; calendarId links the member to a calendar (find it via youcanbookme_list_available_accounts). Use the `fields` passthrough for email, description, pic, etc. The path profileId is never sent in the body.
youcanbookme_update_team_member
MUTATES YouCanBookMe data: updates a team member on a profile. YCBM API: PATCH /v1/profiles/{profileId}/teammembers/items/{teamMemberId} (JSON, partial update). Pass changed fields (name, email, description, calendarId, ...) via the `fields` passthrough. Path ids are never sent in the body.
youcanbookme_create_location
MUTATES YouCanBookMe data: adds a location to a profile. YCBM API: POST /v1/profiles/{profileId}/locations (JSON). Required: kind (location type) and strategy (how it is assigned). Use the `fields` passthrough for value, notes, and other documented fields. The path profileId is never sent in the body.

YouCanBook.me MCP by usefulapi FAQ

How do I add YouCanBook.me MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http youcanbookme https://youcanbookme.usefulapi.io/mcp