Jefit MCP connector

Read your routines and workout history, and build or change routines, from ChatGPT, Claude and other MCP clients.

Connect

Connection URL:

https://mcp.jefit.com/mcp

You need an active Jefit Elite membership. When your client asks, sign in to Jefit and choose read-only or read + write access.

Claude

Open Customize, then Connectors. Select +, then Add custom connector.
Name it Jefit and paste the connection URL.
Select Connect and sign in to Jefit.

On a Team or Enterprise plan, an owner adds the connector for the organization first.

ChatGPT

Jefit is in review for the ChatGPT app directory. Until it is listed, connect with developer mode.

Open Settings, then Apps, and turn on developer mode in the advanced settings.
Create an app named Jefit with the connection URL and OAuth authentication.
Sign in to Jefit when ChatGPT asks.
In a chat, choose Developer mode from the + menu and turn on Jefit.

Developer mode is not available on every ChatGPT plan.

Claude Code

Run claude mcp add --transport http --scope user jefit https://mcp.jefit.com/mcp.
Start Claude Code, run /mcp, select jefit and choose Authenticate.
Sign in to Jefit in the browser window that opens.

Other clients

Claude, ChatGPT and apps that run on your computer, such as Claude Code, can connect. Other web-based AI apps cannot connect yet.

Things to ask

What am I training today, and what did I lift last time on those exercises?
Summarize my workouts from the last two weeks.
How has my bench press progressed over the last 6 months?
Build me a 4-day upper/lower routine for a home gym with dumbbells and a bench.
Swap the barbell rows on my pull day for a dumbbell variation and keep the same sets.
Add a 3-set superset of curls and triceps pushdowns to the end of my arm day.

Tools

Each tool is a read, a write or a sensitive write. A read changes nothing. A write saves or changes data in your account. A sensitive write deletes something for good.

Read

Read. Available with read-only access. Changes nothing.

search_exercises Find exercises by name in the Jefit library and in your custom exercises.
get_exercise Show an exercise's description, equipment and media.
get_current_routine Show the routine you are training now.
list_routines List your routines.
get_routine Show a routine with its days and exercises.
get_day Show one training day with its exercises and sets.
get_sessions Show your workouts in a date range, with every logged set.
get_session Show one workout.
get_log Show one exercise log.
get_exercise_history Show every set you logged for one exercise over a period, to track your progress on it.
get_benchmarks Show your rank among your friends for streak or points.

Create

Write. Needs read + write access. Saved to your account straight away.

create_custom_exercise Create a custom exercise, or reuse one you already have with the same name.
create_plan Create a routine with its days and exercises in one step. If a step fails, Jefit removes what it created and tells you if anything is left.
add_day Add a training day to a routine.
add_day_exercise Add an exercise with its sets to a day.

Change

Write. Needs read + write access. Overwrites what is saved.

set_current_routine Choose which of your routines you are training now.
update_plan Change a routine's name, description, focus, difficulty or days per week.
update_day Rename a day, move it to another weekday, or make it a rest day.
update_day_exercise Change an exercise's sets, rest time or position in a day.
superset_group Group exercises in a day into a superset.

Delete

Sensitive write. Needs read + write access. Permanent: there is no undo, so your AI app should ask you before each one.

delete_day_exercise Remove an exercise from a day.
delete_day Remove a day and every exercise in it.
delete_routine Remove a routine with all its days and exercises.
delete_custom_exercise Remove a custom exercise. This also deletes every log of it and removes it from your routines.

Errors

When Jefit refuses a request, the tool returns an error with one of these codes. Most also carry a line telling your AI app what to do next.

entitlement_required Your Jefit Elite membership is not active. Renew Elite to use the connector again.
insufficient_scope The connection is read-only and the request was a change. Reconnect Jefit and choose read + write.
adaptive_plan_read_only The routine is an Adaptive Plan. Change it in the Jefit app.
routine_not_found No routine of yours has that id. Only your own routines can be the current routine.
invalid_request The request was incomplete or malformed. The message says what to change.
invalid_param A value was not accepted. The message names it.
rate_limited A limit was reached: 60 changes a minute or 2,000 a day. Wait as long as the message says, then continue.
http_403 The item belongs to another account or cannot be changed. Nothing was changed.
http_404 The item does not exist, or it belongs to another account.
pat_disabled Jefit has paused access from AI apps. Your data is unaffected. Try again later.

These come back when your AI app connects, not from a tool:

invalid_token The connection was disconnected or has expired. Reconnect Jefit in your AI app.
connector_not_available Connecting AI apps is not available for this account.
temporarily_unavailable Jefit is briefly unavailable, or access from AI apps is paused. Your data is unaffected. Try again later.

Limits

Your Adaptive Plan can be read, but only changed in the Jefit app. Deleting a custom exercise still removes it from every routine, your Adaptive Plan included.
Logging workouts is not available through the connector. Log them in the Jefit app.
Each connection can save up to 60 changes a minute and 2,000 a day. Every saved item counts, so building a whole plan can use 30 or more. Wait a minute between large plans.
Weights are sent and returned in pounds, whatever units your account shows.
With Periodization on, the Jefit app usually sets the weight and reps of weighted exercises from your current phase. If your AI app changes a set's weight or reps, the app usually keeps that change for the rest of the phase. A newer weight increase can replace it.

How Jefit's recommendations work

Your AI app uses this guide to explain Jefit's suggestions. It covers the progressive overload system in Jefit Elite.

Weight increases

After each workout, Jefit checks each weight-and-reps exercise to see if you are ready for more weight. A new suggestion is ready for your next workout. Jefit needs a few logged sessions before its first suggestion.
A main lift goes up when your top set reaches the top of its rep range. An accessory exercise goes up when most of its sets reach the top of the range and no set falls far short.
An accessory exercise goes up at most once a week. A main lift can go up a second time in the same week.
The step depends on the equipment: a small percentage on a barbell or plate-loaded machine, the next dumbbell or kettlebell, or the next pin on a stack. Weights round to what your equipment can make. When the weight goes up, your target reps can go down within the range. On an assisted exercise, Jefit lowers the assistance instead.
The weight stays the same until you reach the top of the rep range. It also stays the same in a deload week, when your equipment cannot make the next weight, or when you already did many hard sets this week.
Exercises that are not weight-and-reps get no weight suggestions. Custom exercises get them only when they are linked to a similar library exercise.
If you train that exercise in the same plan without using its suggestion, the suggestion is skipped. That workout can create a new one.

Phases and deloads

An Adaptive Plan, or your own plan with Periodization on, runs in phases of one week each: On-Ramp, Accumulation, Intensification and Deload.
For most goals, effort rises across the phases, so sets end closer to failure. With the Maintaining goal, effort stays the same.
The deload week lowers volume and effort so you recover. It brings no weight increases.
With Periodization on, the app sets the weight and reps of weighted working sets from the current phase. A weight or reps you change yourself is usually kept for the rest of the phase. A newer weight increase can replace it.

Repeated weeks

When a week falls far short of its target, Jefit can repeat that phase once with less volume. After that, the plan moves on.
A week falls short when your Progress Index ends below its range, when you do far fewer hard sets than planned, when an Intensification week has no complete top set on a main lift, or when nothing is logged.
Doing more than the target does not repeat a week. A deload week is never repeated.

Progress Index

The Progress Index, also called the North Star Progress Index (NSPI), reads your week so far across three parts: Strength, Stimulus Volume and Movement Balance.
Strength compares this week's best estimated one-rep max on your main movement patterns with your recent sets. Stimulus Volume counts your effective hard sets against your weekly target. Movement Balance checks that push and pull, and squat and hinge, each get their share.
The index has a target range set by your goal, experience level and current phase. Within range is the planned pace. Above range is fast progress with more fatigue. Below range is feedback, not failure: often fewer sets, a stalled lift or less variety.
The index builds up as you log during the week, so read it at the end of the week.

What you can change

Your goal and experience level set how hard each phase is.
Your equipment decides which exercises an Adaptive Plan gives you. The weights you own decide how weights round.
Turning Periodization off pauses the phases, on an Adaptive Plan or your own plan.
Exercise preferences, and swap feedback about an injury, difficulty or preference, change which exercises you get.

Privacy and control

The connector passes your requests to Jefit and keeps no copy of your data. Its own logs record only which tool ran, whether it worked and how long it took, with nothing that identifies you.
Those logs stay on Jefit's server in up to three 10 MB files that rotate, so the oldest are dropped first. They are also cleared each time the connector is updated.
Your AI app receives the training data it reads. The leaderboard tool also sends your friends' ranks and scores, without their names or avatars.
What your AI app receives is covered by its own privacy policy. How Jefit handles the connection is in the Jefit Privacy Policy.
To disconnect, open your Jefit settings, find the app under Connected AI apps, and select Disconnect. Access ends immediately. Changing your password also ends every connection.

Support

Email support@jefit.com.