MCP Fit

Read a paginated mixed page of the connected account’s saved exercises, workouts, schedules, sessions, measurements and preferences, plus its active-workout snapshot. Use limit and offset for pagination. This is not full history; use fit_list_completed_workouts for completed workouts.

Read one completed workout, including its full ordered exercises and sets, and updated_at for fit_update_session or fit_delete_session.

Read the actual phone acknowledgement or pending/expired state of a device action. A pending request is not proof of execution.

Read the shared live-workout snapshot and ready exercise photo references. Missing state is revision 0, status idle, session null. Photo references contain metadata only; call fit_get_workout_photo with a photo ID to view its image.

MCP Fit app data operation: get profile. Summary results are page summaries when paginated.

MCP Fit app data operation: get record. Summary results are page summaries when paginated.

Read planned occurrences and completed-session IDs for an inclusive local-calendar range of up to 84 days. Continue next_offset for all occurrences. Disabled programs are omitted.

Read one training program and its updated_at version.

MCP Fit app data operation: get training summary. Summary results are page summaries when paginated.

Read one of your ready workout photos as an image response.

List completed workout history, newest finished workout first. Use detail "full" to include all exercises and sets; the default summary is smaller. Continue with next_offset.

MCP Fit app data operation: list connections. Summary results are page summaries when paginated.

Read fitness records page by page. For completed workout history use fit_list_completed_workouts, or filter kinds to [session]. Unfiltered pages also contain the exercise library and may contain no sessions; follow next_offset.

List training programs and their complete ordered schedule entries. Continue through next_offset.

List metadata for your workout photos, optionally for one exercise in a session. Images are returned only by fit_get_workout_photo.

List reusable workout templates, with next_offset pagination. Legacy storage kind program means workout template.

Atomically log a workout session. Example: record.data has startedAt, optional finishedAt/programId, and exercises [{id,exerciseId,notes,restSeconds,sets:[{id,weight,reps,seconds,distance,kind,completed,rpe?}]}]. Retry the same idempotency_key after a network failure.

Correct a completed workout logged under the wrong exercise. Move completed sets with their exact values to another owned exercise in this same history entry. Read fit_get_completed_workout first and supply its updated_at. This changes history only, never the saved program or an active workout.

Correct an exercise logged under the wrong name in the active workout. Move completed sets, unchanged, from one live exercise row to another existing row or a new row for an owned exercise. Incomplete planned sets stay with the source. Does not edit the saved program. Read fit_get_live_workout first; supply its revision and a fresh idempotency key.

Move one uncompleted scheduled occurrence to a different local-calendar date. Supply original_date from fit_get_schedule_occurrences; it remains the stable identity for completion and starting.

Ask the connected foreground MCP Fit phone app to navigate to one specified app screen. Queues a request that expires after 15 minutes; poll fit_get_device_request for actual completion. Requires an online foreground phone.

MCP Fit app data operation: patch preferences. Summary results are page summaries when paginated.

MCP Fit app data operation: patch record. Summary results are page summaries when paginated. For saved workouts use kind program; for named schedules use training_program. Read the record and use its updated_at before patching. These edits affect future workouts, never the independent active session or its logged sets/rest timer. To deliberately edit the current session, read fit_get_live_workout and use the revision-checked live tools. Deleting a saved workout removes its schedule entries but the existing active session can still finish.

MCP Fit app data operation: plan warmup. Summary results are page summaries when paginated.

Ask the connected foreground phone app to import supported Apple Health measurements already authorised by the user. May update stored measurements. Queues a request that expires after 15 minutes; poll fit_get_device_request for actual completion. Requires an online foreground phone.

Ask the connected foreground phone app to show its Apple Health permission prompt. Only the user can grant permission on the device. Queues a request that expires after 15 minutes; poll fit_get_device_request for actual completion. Requires an online foreground phone.

Ask the connected foreground phone app to report its Apple Health integration status. Does not grant Health permission. Queues a request that expires after 15 minutes; poll fit_get_device_request for actual completion. Requires an online foreground phone.

Ask the connected foreground phone app to show its notification permission prompt. Only the user can grant permission on the device. Queues a request that expires after 15 minutes; poll fit_get_device_request for actual completion. Requires an online foreground phone.

Ask the connected foreground MCP Fit phone app to synchronise its account data. Queues a request that expires after 15 minutes; poll fit_get_device_request for actual completion. Requires an online foreground phone.

MCP Fit app data operation: revoke connection. Summary results are page summaries when paginated.

Create or replace a complete program schedule: weekdays, times, repeating weeks, date bounds, enabled status and workout or exercise prescriptions. Include the complete ordered entries array. Use expected_updated_at on existing records. This changes future scheduling only; any active workout retains its original snapshot, logged sets and rest timer.

Create or replace a reusable workout including all ordered exercises and sets. Read and pass expected_updated_at to replace an existing template.

MCP Fit app data operation: search records. Summary results are page summaries when paginated.

Set a fixed ISO rest deadline for the current workout, or null to skip/clear rest. Phone and Watch use the same deadline. Use an absolute deadline so retries cannot restart the timer.

Start one shared workout from a complete new session snapshot. The caller must create fresh IDs and reset every set to completed:false.

Start a Training Program occurrence with CAS and idempotency. Pass original_date from fit_get_schedule_occurrences as date; it remains stable when the occurrence has been moved.

Start a reusable Workout template by workout_id. The older fit_start_workout_from_program alias remains available.

Legacy alias: start a reusable workout template, not a schedule. Prefer fit_start_workout or fit_start_scheduled_workout. Uses deterministically generated live exercise and set IDs. Supply the same session_id, started_at and idempotency_key to retry safely; every copied set starts incomplete. Matching previous completed set values are frozen as suggestions; template targets are the fallback.

Undo one uncompleted occurrence move and restore its original local-calendar date.

Log or edit one live set using its stable IDs. Patch only the fields you want to change (kilograms, kilometres). Set completed:true to log it. Read the returned revision before the next action.