usefulapi

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

Claude

Open Settings → Connectors → Add custom connector
Paste this URL:
https://youcanbookme.usefulapi.io/mcp
Authenticate with YouCanBook.me when prompted

Cursor · VS Code · Windsurf · Cline

Add to your MCP config, then reload & authorize:

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

live20 toolsFree 100 tool calls / monthPro $9/mo · $90/yr

Tools 20

Tool	Type	What it does
`list_bookings`	read	List bookings List bookings (appointments), filterable by profile, an after/before time window, cancelled status, and free-text search. YCBM API: GET /v1/bookings.
`get_booking`	read	Get a booking Fetch a single booking (appointment) by id, with optional field selection. YCBM API: GET /v1/bookings/{bookingId}.
`list_profiles`	read	List profiles (booking pages) List all profiles (booking pages) on the account, each a bookable page with its own subdomain, appointment types, team members, and locations. YCBM API: GET /v1/profiles.
`get_profile`	read	Get a profile (booking page) Fetch a single profile (booking page) by id, including nested sub-resources (appointment types, team members, locations). YCBM API: GET /v1/profiles/{profileId}.
`list_team_members`	read	List a profile's team members List the team members configured on a profile (id, name, email, description, pic, calendarId). YCBM API: GET /v1/profiles/{profileId} with a teamMembers field selection.
`list_appointment_types`	read	List a profile's appointment types List the appointment types configured on a profile (id, name, description, slotLength, price). YCBM API: GET /v1/profiles/{profileId} with an appointmentTypes field selection.
`list_locations`	read	List a profile's locations List the locations configured on a profile (id, kind, value, notes, strategy). YCBM API: GET /v1/profiles/{profileId} with a locations field selection.
`list_available_accounts`	read	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.
`youcanbookme_request`	read	Raw read request Power-user escape hatch to GET any YCBM API path not wrapped by a dedicated tool (read-only; only GET is allowed). Returns the parsed JSON.
`create_booking`	write	Create a booking Create a booking (appointment) on a profile from profileId, startsAt, and endsAt, with optional title, timeZone, locale, and units. YCBM API: POST /v1/bookings.
`update_booking`	write	Update a booking Update an existing booking to reschedule, rename, or mark cancelled/no-show via a partial update. YCBM API: PATCH /v1/bookings/{bookingId}.
`cancel_booking`	write	Cancel a booking Cancel a booking (a reversible wrapper that sets cancelled=true, safer than deleting). YCBM API: PATCH /v1/bookings/{bookingId}.
`update_profile`	write	Update a profile (booking page) Update a profile's (booking page) configuration via a partial update of documented profile fields. YCBM API: PATCH /v1/profiles/{profileId}.
`create_appointment_type`	write	Create an appointment type Add an appointment type (name plus optional description, slotLength, price) to a profile. YCBM API: POST /v1/profiles/{profileId}/appointmenttypes/items.
`update_appointment_type`	write	Update an appointment type Update an appointment type on a profile via a partial update of its fields. YCBM API: PATCH /v1/profiles/{profileId}/appointmenttypes/items/{appointmentTypeId}.
`create_team_member`	write	Add a team member Add a team member (name, optional calendarId and other fields) to a profile. YCBM API: POST /v1/profiles/{profileId}/teammembers/items.
`update_team_member`	write	Update a team member Update a team member on a profile via a partial update of its fields. YCBM API: PATCH /v1/profiles/{profileId}/teammembers/items/{teamMemberId}.
`create_location`	write	Add a location Add a location (kind and strategy plus optional value and notes) to a profile. YCBM API: POST /v1/profiles/{profileId}/locations.
`youcanbookme_usage_status`	meta	Usage status (free-tier meter) Report the caller's current free-tier usage this month: calls used, monthly limit, remaining, and whether the cap is reached. Read-only; does not count against the meter.
`youcanbookme_upgrade`	meta	Upgrade to Pro (unlimited) Subscribe to the Pro plan for UNLIMITED YouCanBook.me tool calls (the free tier caps monthly usage). Choose monthly ($9/month) or yearly ($90/year — 2 months free) billing. Returns a Stripe Checkout link to open in your browser; after payment your account upgrades automatically. Read-only; does not count against the meter.

Pricing

Plan	Price	Limit
Free	$0	100 tool calls / month
Pro	$9/mo · $90/yr	Unlimited

This is a Model Context Protocol endpoint — meant to be connected from an AI client, not opened in a browser. An invalid_token response at the URL is the auth gate working as designed; clients authenticate automatically.