CloudFit APIAPI referenceTechnical guideMCP guide

Connect AI apps with MCP

CloudFit has an MCP server, so AI apps such as Claude and ChatGPT can work with your CloudFit locations: read and build workouts, find exercises, manage the exercise and media libraries, and plan the class schedule. You ask in plain language and the app calls CloudFit for you.

The CloudFit API is in Beta and needs the Business plan. Owners, HQ owners and staff can connect; an app can never do more than you can do in CloudFit yourself.

The server URL

https://api.cloudfit.tv/mcp

Every app below uses this URL. You sign in to CloudFit in your browser and choose what the app may do; you never handle a password or token.

Connect an app

Claude (web, desktop and mobile)

The quickest way: open CloudFit in Claude’s directory and select Connect. A directory connector doesn’t count toward the Free plan’s one custom connector.

Or add it yourself:

  1. In Claude, go to Customize → Connectors, select Add, then Add custom connector.
  2. Name it CloudFit, paste https://api.cloudfit.tv/mcp as the URL and select Continue. Keep the sign-in settings Claude detects.
  3. Select Add, then Connect. A CloudFit page opens: sign in, pick the locations and whether Claude may only read or also make changes, then approve.
  4. In a chat, turn CloudFit on under + → Connectors.

On a Team or Enterprise plan, an owner adds the connector once under Organization settings → Connectors, and each person then connects with their own CloudFit account. On the Free plan Claude allows one custom connector.

To check it works, ask: “Which CloudFit locations can you see, and what can you do at each?” It should list the locations you ticked, with your role and whether it can make changes. If a location is missing or it can only read, disconnect and connect again with the access you want.

ChatGPT

ChatGPT connects to MCP servers as plugins, on the web.

  1. Open ChatGPT Plugins, select +, then Add custom MCP server.
  2. Name it CloudFit and enter https://api.cloudfit.tv/mcp as the Server URL.
  3. Under authentication choose OAuth, read the warning and continue, then select Create as a plugin.
  4. Install the plugin from your plugins. A CloudFit page opens: sign in, pick locations and access, and approve.
  5. In a chat, type @ and pick CloudFit, then ask the same check: “Which CloudFit locations can you see, and what can you do at each?”

If Add custom MCP server isn’t there, your plan or workspace may not allow custom servers yet; a workspace admin may need to turn it on. OpenAI describes the steps in Add a custom MCP server.

To add exercise videos or images in ChatGPT, attach them to the chat and ask, for example, “Add these as exercises.” CloudFit fetches the attached files itself, so there’s no link to open. This works in ChatGPT on the web; if the phone app can’t pass the files on, ChatGPT gives you the upload page instead. Before adding them, the AI suggests a name, equipment and categories for each one for you to check, and asks before your video replaces one of CloudFit’s built-in exercises.

Claude Code

claude mcp add --transport http cloudfit https://api.cloudfit.tv/mcp

Then run /mcp in Claude Code, pick cloudfit and choose Authenticate. Your browser opens the CloudFit page; it warns that the app runs on your computer, which is expected for Claude Code.

Codex

codex mcp add cloudfit --url https://api.cloudfit.tv/mcp
codex mcp login cloudfit

The login opens the CloudFit page in your browser, as for Claude Code.

Other MCP clients and scripts

Signing in with CloudFit works for Claude, Claude Code, ChatGPT and Codex. Any other MCP client can use a personal token instead: create one in the CloudFit app under Settings → AI & API Access, then send it as a header, Authorization: Bearer cf_api_live_…. Treat it like a password. The technical guide explains tokens and scopes.

What you approve

Things to ask

When you add videos or images, the app usually gives you a link: open it in your browser and choose the files from your computer or phone. In ChatGPT you can attach exercise videos and images to the chat instead. If your AI app asks to allow other websites to get at your files, you can say no and use the link instead.

What it can’t do

An AI app connected to CloudFit works with workouts, exercises, media, the class schedule and published workouts. It can’t press start or stop on your displays, control the TVs, manage members or bookings, or change billing. But what it changes does reach the TVs: classes it schedules start on their own at their time, and a workout it edits plays the new version the next time it starts.

At an HQ, changes reach every location that uses the HQ’s library: editing or deleting an HQ workout or exercise changes it for them too.

How changes stay safe

CloudFit enforces these itself, whatever the app does:

And CloudFit tells the app to do these, which good apps do:

Limits that also apply:

Tools

The server offers these tools. Your app picks them; you don’t need to name them. “Needs” is the access the tool uses: read scopes come with any connection, and change scopes need read-and-change access and the matching CloudFit permission. Previews and upload checks change nothing but need change access, since they’re steps of a change. report_missing_capability lets the app send CloudFit a short note about something you asked for that it can’t do yet. The app is told to ask you first, show you the note, and describe only the missing feature, without workout details, exercise lists, links or names.

Locations

ToolWhat it doesAccessNeeds
list_locationsList locationsReads onlyany access
get_locationGet a locationReads onlylocations:read
report_missing_capabilityTell CloudFit about a missing featureChangesany access

Workouts and folders

ToolWhat it doesAccessNeeds
list_workout_historyList workout historyReads onlyworkouts:read
list_foldersList foldersReads onlyworkouts:read
create_folderCreate a folderChangesworkouts:write
list_workoutsList workoutsReads onlyworkouts:read
get_workoutGet a workoutReads onlyworkouts:read
validate_workoutValidate a workout specReads onlyworkouts:read
create_workoutCreate a workoutChangesworkouts:write
duplicate_workoutDuplicate a workoutChangesworkouts:write
preview_workout_editsPreview workout editsReads onlyworkouts:write
apply_workout_editsApply workout editsChanges; can replace or removeworkouts:write
delete_workoutDelete a workoutChanges; can replace or removeworkouts:write
publish_workoutPublish a workoutChanges; can replace or removeworkouts:write
unpublish_workoutUnpublish a workoutChanges; can replace or removeworkouts:write

Exercises

ToolWhat it doesAccessNeeds
list_custom_exercisesList custom exercisesReads onlyexercises:read
create_exerciseCreate an exerciseChangesexercises:write
create_exercise_uploadCreate an exercise media upload linkChangesexercises:write
get_exercise_uploadCheck an exercise media uploadReads onlyexercises:write
create_exercise_importStart an exercise importChangesexercises:write
add_exercise_import_filesAdd files to an exercise importChangesexercises:write
add_exercises_from_filesAdd exercises from attached files (ChatGPT only)Changesexercises:write
get_exercise_importCheck an exercise importReads onlyexercises:write
rename_exercisesRename exercisesChanges; can replace or removeexercises:write
update_exercisesUpdate exercisesChanges; can replace or removeexercises:write
get_exercise_usageShow where an exercise is usedReads onlyexercises:read
delete_exerciseDelete an exerciseChanges; can replace or removeexercises:write
get_exercise_download_linksGet exercise download linksReads onlyexercises:read
search_exercisesSearch exercisesReads onlyexercises:read

Media

ToolWhat it doesAccessNeeds
list_mediaList mediaReads onlymedia:read
create_media_uploadCreate a media upload linkChangesmedia:write
get_media_uploadCheck a media uploadReads onlymedia:write

Schedule

ToolWhat it doesAccessNeeds
list_scheduleList the scheduleReads onlyschedule:read
preview_schedule_changesPreview schedule changesReads onlyschedule:write
apply_schedule_changesApply schedule changesChanges; can replace or removeschedule:write

Limits

The limits are generous for building workouts and planning schedules, and slow down bulk copying. When a per-minute or daily limit is reached, the tool error says how long to wait (retryAfterSeconds), and the app can try again then. The bulk import allowance works differently: when it’s used up, adding files says so (exercise_import_limit_reached) with how many remain and when room frees up (details.remaining, details.nextFreesAt).

LimitAllowance
Every request or tool call120 a minute per token or connected app, and 240 a minute per person across all of them
Validating and previewing, listing media, exercise downloads60 a minute per person
Changes (create, duplicate, apply edits, publish, schedule changes, uploads, folders, exercises)30 a minute per person and 30 a minute per location
Exercise searches200 a day per person
Workouts archived10 a day per location (unarchiving isn’t limited)
Workouts deleted10 a day per location
Workouts published, updated or unpublished30 a day per location
Exercises created50 a day per location
Exercises imported (bulk import)200 per location in any 7 days; CloudFit can raise it for a larger library
Exercises renamed50 a day per location
Exercises updated (equipment, categories)200 a day per location
Exercises deleted20 a day per location
Exercises given download links200 a day per location

Troubleshooting

Every error has a stable code; the full list is in the technical guide.

This page as Markdown