YouCanBook.me MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.38.4Updated Nov 7, 2026

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

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableProductivity & WorkflowCommunication & Collaboration

Overview

AI-generated overview

Hosted MCP server for YouCanBook.me that lets an assistant read and edit bookings, booking pages, appointment types, team members and locations.

What you can do
  • List and fetch bookings, with time-range, profile, cancelled and text filters
  • List and fetch booking pages (profiles) and their appointment types, team members and locations
  • List available accounts/calendars to find a calendarId
  • Create, update and cancel bookings, and update profiles
  • Create and update appointment types, team members and locations
  • Send a raw read-only GET to any YouCanBook.me API path
When to use it
Use it when you want an assistant to answer questions about scheduled appointments or to make scheduling changes in YouCanBook.me — checking a week's bookings, reviewing a booking page's setup, or creating, rescheduling and cancelling appointments.
Requirements
A remote MCP endpoint added by URL only; sign-in is via OAuth, and on first connect you supply your YouCanBook.me Account ID and API key (dashboard → My Account → Security), sent as HTTP Basic auth. A free plan allows 50 tool calls per month; paid plans are available.
Before you install
Many tools write to your YouCanBook.me data: creating, updating and cancelling bookings, and changing profiles, appointment types, team members and locations. The server asks for your Account ID and API key, so treat them as secrets. Usage is metered per account, and the upgrade tool returns payment links for paid plans billed through Stripe.

Installation

In SourceWeft

  1. Open YouCanBook.me MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Fyoucanbookme/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

YouCanBook.me MCP by usefulapi

Manage your YouCanBook.me scheduling from Claude, Cursor, or any MCP client — read and edit bookings, booking pages, appointment types, team members and locations.

Live endpoint: https://youcanbookme.usefulapi.io/mcp · Homepage: https://usefulapi.io/youcanbookme

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://youcanbookme.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http youcanbookme https://youcanbookme.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "youcanbookme": {      "url": "https://youcanbookme.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your YouCanBook.me credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/youcanbookme/

On first connect you'll paste two values — your Account ID and API key (YCBM dashboard → My Account → Security). They're sent as HTTP Basic auth; your Account ID is your stable identity for metering.

Tools

ToolTypeWhat it does
youcanbookme_list_bookingsreadList bookings
youcanbookme_get_bookingreadGet a booking
youcanbookme_list_profilesreadList profiles (booking pages)
youcanbookme_get_profilereadGet a profile (booking page)
youcanbookme_list_team_membersreadList a profile's team members
youcanbookme_list_appointment_typesreadList a profile's appointment types
youcanbookme_list_locationsreadList a profile's locations
youcanbookme_list_available_accountsreadList available accounts (calendars)
youcanbookme_requestreadRaw read request
youcanbookme_create_bookingwriteCreate a booking
youcanbookme_update_bookingwriteUpdate a booking
youcanbookme_cancel_bookingwriteCancel a booking
youcanbookme_update_profilewriteUpdate a profile (booking page)
youcanbookme_create_appointment_typewriteCreate an appointment type
youcanbookme_update_appointment_typewriteUpdate an appointment type
youcanbookme_create_team_memberwriteAdd a team member
youcanbookme_update_team_memberwriteUpdate a team member
youcanbookme_create_locationwriteAdd a location
youcanbookme_usage_statusmetaUsage status (free-tier meter)
youcanbookme_request_featuremetaRequest a missing feature
youcanbookme_upgrademetaUpgrade to Pro or Pro+
youcanbookme_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with youcanbookme_upgrade (it returns a Stripe Checkout link). Cancel any time with youcanbookme_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running youcanbookme_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT © usefulapi. Not affiliated with or endorsed by YouCanBook.me.

Source: servers/youcanbookme/README.md at commit 4046075

Tools

18

youcanbookme_list_bookings

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 unfiltered reads, or fromBookingId for filtered reads. Returns a JSON array of bookings.

ParameterspageafterbeforefieldsparamscancelledprofileIdmaxResultssearchText

youcanbookme_get_booking

Get a 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.

ParametersfieldsbookingIdrequired

youcanbookme_list_profiles

List profiles (booking pages)

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.

ParameterspagefieldsparamsmaxResults

youcanbookme_get_profile

Get a profile (booking page)

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.

ParametersfieldsprofileIdrequired

youcanbookme_list_team_members

List a profile's 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).

ParametersprofileIdrequired

youcanbookme_list_appointment_types

List a profile's 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).

ParametersprofileIdrequired

youcanbookme_list_locations

List a profile's 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).

ParametersprofileIdrequired

youcanbookme_list_available_accounts

List available accounts (calendars)

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.

Takes no parameters.

youcanbookme_request

Raw read 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.

Parameterspathrequired

youcanbookme_create_booking

Create a 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.

ParameterstitleunitsendsAtrequiredfieldslocalestartsAtrequiredtimeZoneprofileIdrequired

youcanbookme_update_booking

Update a 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.

ParameterstitleunitsendsAtfieldslocalenoShowstartsAttimeZonebookingIdrequiredcancelled

youcanbookme_cancel_booking

Cancel a 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.

ParametersbookingIdrequired

youcanbookme_update_profile

Update a profile (booking page)

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.

ParametersfieldsprofileIdrequired

youcanbookme_create_appointment_type

Create an 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.

ParametersnamerequiredfieldsprofileIdrequired

youcanbookme_update_appointment_type

Update an 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.

ParametersfieldsprofileIdrequiredappointmentTypeIdrequired

youcanbookme_create_team_member

Add a 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.

ParametersnamerequiredfieldsprofileIdrequiredcalendarId

youcanbookme_update_team_member

Update a 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.

ParametersfieldsprofileIdrequiredteamMemberIdrequired

youcanbookme_create_location

Add a 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.

ParameterskindrequirednotesvaluefieldsstrategyrequiredprofileIdrequired

Version history

22
  1. v1.38.4LatestNov 7, 2026
  2. v1.37.3Nov 5, 2026
  3. v1.37.2Nov 5, 2026
  4. v1.37.1Nov 4, 2026
  5. v1.37.0Nov 3, 2026
  6. v1.36.1Nov 3, 2026
  7. v1.35.0Nov 1, 2026
  8. v1.33.0Oct 31, 2026
  9. v1.32.0Oct 31, 2026
  10. v1.31.2Oct 30, 2026
  11. v1.31.0Oct 30, 2026
  12. v1.25.0Oct 26, 2026
  13. v1.22.3Oct 25, 2026
  14. v1.22.0Oct 25, 2026
  15. v1.21.0Oct 24, 2026
  16. v1.18.0Oct 23, 2026
  17. v1.16.4Oct 22, 2026
  18. v1.16.3Oct 21, 2026
  19. v1.11.1Oct 9, 2026
  20. v1.10.0Oct 9, 2026
  21. v1.0.1Sep 29, 2026
  22. v1.0.0Sep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations