MCP App Store
by KeenEthics
Kronos icon

Kronos MCP Server for Claude and ChatGPT

By Kronos

Overview

Kronos is a workout app and interval timer. Connect it to Claude and your chat becomes your coach, while Kronos does the training. Ask for a workout, a timer or a multi-week plan, and it lands in the Kronos app ready to run, with a timer for every set and rest, your weights, and logging. You see a preview in the chat before anything is saved. What you can do: - Create workouts and interval timers, and send them to your phone. - Build multi-week plans with progression. Plans arrive as a draft you review and start in the app. - Change this week or next week of your plan: swap one move, change sets, reps or weight, skip or replace a session, move days or add a session. Only what you ask changes. - Change a saved workout the same way. It is saved as a new workout and yours stays as it was. - Add weeks to the end of the plan you are running. - Let Claude read your equipment, your schedule, your plan, your saved workouts and your training history, so what it writes fits you. - Ask how one exercise has gone over time, or tell Claude how a session went. It can read what you did and plan the next one. - For coaches: send a plan to a client who linked you, with the rules you want kept, see what you sent, and read the training a client chooses to share with your AI. - Send feedback to the Kronos team from the chat. You stay in control. You approve the connection in the Kronos app and choose what Claude may do. Changes to your plan are previewed first, and nothing starts by itself. Heart rate, notes, feelings and injuries are never shared. Disconnect at any time from Connected AI in Kronos. Timers run free on every Kronos account, and your first AI workout is free. Plans, plan changes and training history need Kronos Pro or the free trial.

How to connect

  1. Claude: Open the Kronos listing in the Claude connectors directory and choose Connect. Claude listing Kronos exposes 31 tools here.
  2. ChatGPT: Open the Kronos listing in the ChatGPT app directory and choose Connect. ChatGPT listing Kronos exposes 31 tools here.

Tools

accept_coach_invite

ChatGPT
Link this Kronos account as a coach to a client who made an invite in their Kronos app (Connected apps, Let a coach send me plans) and shared its 8-character code. Returns the client's clientId and display name. After that, prepare_client_plan and send_plan_to_client can propose workouts and plans to them; nothing of the client's history is ever readable. The client can end the link at any time. Errors: invalid, expired, own, rate_limited.

commit_prepared

ChatGPT
Save exactly the workout or plan behind a preparedId from prepare_workout or prepare_plan. A workout goes to the member's saved workouts; a plan is saved as a draft plan the member reviews and starts in the Kronos app (it never replaces the plan they are running). Returns a receipt: receiptId, a link that opens it in Kronos, and runEligibility: "pro" (the member can run it), "free_first_run" (it can run once on this account's one free AI-sent run), or "needs_pro" (saved; running it is part of Kronos Pro). Calling again with the same preparedId returns the same receipt and saves nothing twice. Errors: expired (previews last 30 minutes), stale_compiler or hash_mismatch: a new preview is needed; wrong_tool: a week edit goes through commit_week_edit.

commit_week_edit

ChatGPT
Apply exactly the changes behind a preparedId from prepare_week_edit or prepare_add_weeks. Every target is checked again now, in the member's own week: unstarted, and at the revision the preview read. Any miss rejects the whole edit and changes nothing (stale_revision, week_changed, stale_week, session_started: the week has moved on and needs a new preview). Returns a receipt. Calling again with the same preparedId returns the same receipt and applies nothing twice.

get_client_training

ChatGPT
Read what a coaching client did, ONLY where that client chose to let this coach's AI read it (their Kronos app, Profile > Coaching): the plan and week, sessions done against prescribed (sets, reps, loads, RPE 1-10, swaps with reasons, skips) and whether each change was within the coach's rules. Without clientId: a short summary for every readable client. With clientId: that client's recent sessions in detail. Clients who did not allow it are listed by name with no data; tell the coach to look in Kronos Studio. Revoked access stops at once. Use it to answer the coach; never message the client or decide for the coach.

get_exercise_history

ChatGPT
Every day the member logged one exercise in Kronos, newest first: sets logged, the top set (reps, load in kg, RIR), the day's estimated one-rep max (Epley, from sets of 12 reps or fewer) and volume (load x reps, kg). exerciseId is a catalogue id from search_exercises, get_workout or get_recent_training. days sets how far back: 365 by default, up to the member's whole history (3660). The summary covers every day read: how many, the first and last date, the heaviest set and the best estimated one-rep max with their dates. Up to 80 days of training a call. Sets Kronos logged by itself that the member never confirmed do not count as bests.

get_last_debrief

ChatGPT
The member's latest finished Kronos session in the last 30 days: per exercise what was prescribed (sets, reps, load in kg, seconds) beside what was done (each logged set's reps, load in kg, seconds, RPE and RIR), the moves skipped, and the bests set in it. A best means better than anything the member logged earlier in the same 30 days.

get_my_plan

ChatGPT
The member's personal Kronos plan from start to end: its name, whether it rolls on by itself, how many weeks it has and which one is current, and every week's sessions by name, minutes, day and status (planned, started, done, skipped). The last 8 finished weeks, this week, and up to 24 weeks ahead. Sessions of this week and later carry an occurrenceId for get_workout. Only this week and next week can be changed (get_my_week gives the revision ids prepare_week_edit needs); weeks further ahead are added with prepare_add_weeks. On a rolling plan, weeks ahead are not written until they open.

get_my_setup

ChatGPT
The member's training setup in Kronos: the equipment at each of their training places (equipment ids only), their weight unit, fitness level, target training days a week, usual session length in minutes, and goal category. Values the member has not set are "unknown".

get_my_week

ChatGPT
This week and next week of the member's personal Kronos plan. For each session: occurrenceId, revisionId, week (this or next), day (0 = Sunday; "unknown" means the session has no fixed day and the member runs the week in order), name, minutes, slotKind (mine, anchored, open = Kronos builds it), contentKind and status (planned, started, done, skipped). Unstarted sessions in both weeks can be changed with prepare_week_edit, using their occurrence and revision ids. rolling says whether the plan carries on by itself. nextWeek is null on a rolling plan until this week ends, and on a fixed plan's last week.

get_receipt

ChatGPT
Re-read one thing this connection saved to Kronos, by its receiptId: what it is, its status (saved, notified, opened, reviewed, started), its open link and its runEligibility. Only receipts made through this same connection. Nothing else from the member's account.

get_recent_training

ChatGPT
The member's Kronos sessions from the last 1 to 30 days (default 30), newest first, up to 20 a page: date (UTC), name, minutes, whether it was completed and counted, and per exercise the number of sets logged and the top set (reps, load in kg, RPE and RIR as logged). The first page also lists, per loaded exercise, the heaviest set inside the window. Missing values are "unknown". Pass nextCursor back as cursor for the next page.

get_workout

ChatGPT
The prescription Kronos would run for one saved workout (workoutId) or one plan session (occurrenceId from get_my_week): blocks (mode, sets or rounds, rests, caps, EMOM intervals, how a sets block groups its moves), moves, reps or seconds, loads in kg with per-hand or total stated and whose number each is, %, RPE, RIR and AMRAP targets, every written set on its own (steps[].sets: a top set and back-offs, 5/3/1), and which values Kronos filled. Send exactly one of workoutId or occurrenceId.

kronos_status

ChatGPT
The connected Kronos account: its tier (free or pro), the permissions this connection has, the member's weight unit when set, the workout format version Kronos accepts, the call limits, and freeRun: whether this account's one free run of an AI-sent workout is available, held by a session running now, or used.

list_client_deliveries

ChatGPT
The workouts and plans this coach has sent, newest first: each one's deliveryId (what replacesDeliveryId takes), the client, kind, name, the date sent, version, a plan's weeks and sessions a week, the deliveryId it replaced, and status. Status is delivered (it reached the client's app) or started (the client is running the plan); started is told only for clients who let this coach's AI read their training, and every other send reads delivered. Without clientId: the latest 5 per client. With clientId: that client's latest 20.

list_my_clients

ChatGPT
The clients who have linked this account as their coach: each one's clientId (for prepare_client_plan) and display name, and since when. Nothing else about them is available.

list_my_timers

ChatGPT
The member's saved Kronos timers: each timer's id, name, format (intervals, tabata, emom, amrap, for_time) and total length in seconds. Up to 50, most recently changed first.

list_my_workouts

ChatGPT
The member's saved Kronos workouts, most recently used or changed first, up to 50: each one's workoutId (for get_workout), name, minutes, number of blocks, the date it last changed, the date it was last finished and how many times, and whether a connected AI app saved it. query keeps only names containing that text. Saved workouts are not the plan: the plan's sessions are get_my_week and get_my_plan.

prepare_add_weeks

ChatGPT
Adds weeks to the end of the plan the member is running. The alternative is prepare_plan, a separate draft they start in the app. plan is kronos.plan/v1, the same as prepare_plan; its week 1 lands straight after the plan's last week. afterLastWeek sets what happens next: "finish" ends the plan after the added weeks, which turns a rolling plan into a fixed-length one (the default); "keep_rolling" leaves the plan rolling on after them. Returns a preview with addWeeks.summary, one sentence saying what changes, and a preparedId that expires in 30 minutes; nothing changes until commit_week_edit. Errors: no_plan (no plan is running), too_many_weeks, invalid_payload (each listed path has its fix).

prepare_client_plan

ChatGPT
Check and compile a workout (kronos.workout/v1) or a plan (kronos.plan/v1) to send to one linked client (clientId from list_my_clients). Returns the preview and a preparedId that expires in 30 minutes; nothing reaches the client until send_plan_to_client. Errors: not_found (no such client for this account), not_linked (the client ended the link), invalid_payload (each listed path has its fix).

prepare_creator_draft

ChatGPT
For a Kronos creator only: check and compile a workout (kronos.workout/v1) or a plan (kronos.plan/v1) as a DRAFT programme for the creator's own Studio. A workout becomes session A of a one-week programme; a plan keeps its weeks (rounded up to 1, 2, 4, 6 or 8) and its sessions (2 to 5 a week). Returns the preview and a preparedId that expires in 30 minutes; nothing is saved until save_creator_draft. An account that is not a creator gets not_a_creator. On invalid_payload nothing is saved: each listed path has its fix.

prepare_plan

ChatGPT
Check and compile a multi-week plan (kronos.plan/v1: weeks of days, each day a workout or a timer, plus typed repeat rules) before saving it to Kronos. Repeats are expanded before the preview and every week is checked. Returns a preview (each week's sessions and where each came from, the written sessions in full, what Kronos filled, warnings, questions) and a preparedId that expires in 30 minutes. Committing it (commit_prepared) saves a DRAFT plan the member reviews and starts in the app; it never replaces the plan they are running. Weeks that follow on from a running plan are prepare_add_weeks. Size limits are errors, never trimmed: at most 52 weeks, 14 sessions a week, 240 sessions in all, and 120 written sessions (weeks repeated exactly as written cost nothing). On invalid_payload nothing is saved: each listed path carries its fix.

prepare_week_edit

ChatGPT
Check changes to THIS WEEK or NEXT WEEK of the member's Kronos plan: replace a session, move one to another day, add one, or swap two sessions' days. Targets are occurrenceIds and revisionIds (as expectedRevisionId) from get_my_week. week is "this" or "next"; without it the first session named decides. One edit changes one week. Started or finished sessions, past weeks and deletions cannot be changed. Weeks further ahead are prepare_add_weeks. Returns a before/after preview and a preparedId that expires in 30 minutes; nothing changes until commit_week_edit. Errors: stale_revision (the session changed since it was read), session_started, no_next_week (the plan has no next week yet), no_plan, invalid_payload (each listed path has its fix).

prepare_workout

ChatGPT
Check and compile one workout before saving it to Kronos. Send EITHER workout (structured kronos.workout/v1; catalogIds come from search_exercises) OR text (the Kronos text format, starting KRONOS WORKOUT). Free text is refused. The result is a workout to run: it is not scheduled and is not a session of the member's plan. Sessions in the plan are prepare_week_edit. Returns a preview of exactly what Kronos will save and the player will run (canonical text, blocks, moves and doses, what Kronos filled, moves kept as custom, warnings and questions), plus a preparedId that expires in 30 minutes. Nothing appears in the member's app until commit_prepared. On invalid_payload nothing is saved, and errors lists every problem with its path and an exact fix.

prepare_workout_edit

ChatGPT
Check small changes to one of the member's SAVED workouts (workoutId from list_my_workouts): swap one move, change sets, reps, load or rest, take a move or a block out, add a block, rename it. Every step not named stays exactly as it is. Returns the changes in words, the workout as it would read after them, and a preparedId that expires in 30 minutes. commit_prepared then saves the result as a NEW saved workout; the one it started from is not changed. A session in the member's plan is changed with prepare_week_edit (adjust_session) instead. Errors: not_found, invalid_payload (each listed path has its fix; a change this cannot make exactly says to write the whole workout with prepare_workout).

save_creator_draft

ChatGPT
Save exactly the draft behind a preparedId from prepare_creator_draft, as a NEW draft programme in the creator's own Kronos Studio. It is never published and never changes a programme the creator already has. Returns the draft's programmeId and studioUrl, plus any session that could not be placed (it stays empty for the creator to fill). Calling again with the same preparedId returns the same draft and saves nothing twice. Errors: expired, stale_compiler or hash_mismatch: a new preview is needed; not_a_creator.

search_exercises

ChatGPT
Find Kronos catalogue exercises by name, in any language. Returns up to 20 matches, each with its catalogue id, English name, name in the member's app language, equipment, movement pattern, whether it is unilateral (worked one side at a time), its load style (per_hand: a number is per dumbbell or kettlebell; total: the whole weight; bodyweight: no added load), whether it is measured by time or distance, and its dosage bands. The id is a workout's catalogId.

send_feedback

ChatGPT
Passes a message from the member to the people who make Kronos: a bug, something they wish it did, or anything else they want the team to hear. It holds the member's own words and nothing from their training. The team reads every one and cannot reply through this connection. Limit: 5 an hour.

send_plan_to_client

ChatGPT
Send exactly the workout or plan behind a preparedId from prepare_client_plan. It lands in the client's Kronos app as a draft (a saved workout, or a plan to review) marked as from their coach; the client starts or dismisses it, and running it follows the client's own Kronos membership. Returns a delivery receipt (deliveryId, status delivered); nothing else about the client comes back. Calling again with the same preparedId returns the same receipt and sends nothing twice. Errors: not_linked (the client ended the link: nothing was sent), rate_limited (10 sends a day to one client), expired, hash_mismatch.

send_timer

ChatGPT
Save an interval timer (kronos.timer/v1: intervals, tabata, emom, amrap or for_time, with rounds, work and rest seconds, and optional move names) to the member's Kronos timers. Timers run free on every Kronos account. No loads or sets: weighted or set-based sessions are prepare_workout. Returns a receipt with the timer's id, total length, a link that opens Kronos, and runEligibility "free_timer". On invalid_payload nothing is saved: each listed path carries its fix. Sending the same timer again returns the same receipt.

send_to_phone

ChatGPT
Notify the member's phone about one thing this connection saved to Kronos, by its receipt id (id, the receiptId from commit_prepared or send_timer). Tapping the notification opens it in Kronos for review; nothing starts by itself. The notification never shows the workout's details. Returns state: "notified" (one notification was handed to the push service; delivery is not confirmed), "no_device" (no phone with Kronos notifications), "push_off" (Kronos notifications are paused), or "rate_limited" (one went out for this item in the last 10 minutes, or the day's sends are used up), plus openLink, which opens the item. Saved workouts, plans and timers also show in Kronos until the member starts or dismisses them. On a free account it sends timers and the one AI-sent workout or plan that can run free; anything else is needs_pro. Errors: not_found (not a receipt of this connection).

start_on_tv

ChatGPT
Notify the member's phone to start one saved workout or timer (its receipt id, id) on the screen paired with that phone (getkronos.app/tv). Tapping the notification opens the review with the paired screen selected; the member starts it on the phone, which stays in control. Kronos never starts the player itself. Returns the same states as send_to_phone, plus screens (how many paired screens are live). Errors: session_in_progress (a workout is under way: nothing is sent, and the session is never changed), no_display (no screen is paired with the member's phone), wrong_kind (only workouts and timers), not_found.

accept_coach_invite

Claude

commit_prepared

Claude

commit_week_edit

Claude

get_client_training

Claude

get_exercise_history

Claude

get_last_debrief

Claude

get_my_plan

Claude

get_my_setup

Claude

get_my_week

Claude

get_receipt

Claude

get_recent_training

Claude

get_workout

Claude

kronos_status

Claude

list_client_deliveries

Claude

list_my_clients

Claude

list_my_timers

Claude

list_my_workouts

Claude

prepare_add_weeks

Claude

prepare_client_plan

Claude

prepare_creator_draft

Claude

prepare_plan

Claude

prepare_week_edit

Claude

prepare_workout

Claude

prepare_workout_edit

Claude

save_creator_draft

Claude

search_exercises

Claude

send_feedback

Claude

send_plan_to_client

Claude

send_timer

Claude

send_to_phone

Claude

start_on_tv

Claude

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/kronos"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/kronos)