Simple Muscle

Use this when you need raw logged sets for one exercise across past sessions, newest first — for progress analysis and picking the next target weights. For a visual progress summary, also use show_training_stats with the exercise_id.

get_exercise_history

One workout in full detail, including per-set targets and plan_ids for editing.

get_workout

Use this when the user wants to review recorded workouts or adapt training based on completed sessions. Returns actual saved sessions, newest first; filter by date range or source workout. Empty results mean no recorded sessions in that range, not that the user did not train. Does not log workouts or change history.

list_history

Use this when you need raw workout template data for reasoning or editing. For a user-facing overview like 'what workouts do I have?', prefer show_workout_overview so the client can render the SimpleMuscle UI.

list_workouts

Open the Simple Muscle training dashboard to view saved workout plans, recent completed sessions, recorded progress and the exercise library. Use this when the user asks to open their training dashboard or get started with a saved plan. New accounts see first-plan setup. Opening the dashboard does not create or edit workouts and does not log completed sessions. Not needed for general fitness questions.

open_training_dashboard

Use this when the user requests a change in chat with a SimpleMuscle selection attachment (workspace_id and base_revision), including swapping the selected exercise. The existing workspace automatically displays the resulting draft for review; do not open another widget. Stage typed changes to one existing workout for review. Does not save changes to the workout or alter completed history. Use catalog IDs and exact plan_id for repeated exercises.

propose_workout_edit

Use this to inspect exercise instructions and up to ten recent recorded sessions, with images for the workspace.

get_workspace_exercise

Read exercise image and instruction data without opening UI. For in-place exercise view recovery only; use show_exercise_info when the user explicitly requests to see an exercise.

get_exercise_view

Use this to read current native-compatible training preferences and their settings schema.

read_plugin_settings

Use this to inspect an exact owned proposal and its before/after comparison.

get_workout_proposal

Use this to read a saved workout with base_revision and stable plan/set identifiers, and the pending draft for a specific workspace. Weights are kilograms.

get_workout_editor

Read current workout overview data without opening UI. Use for in-place widget refresh and recovery. Never call a show_* tool to recover missing widget data.

get_workout_overview

Use this to refresh workspace data without opening another UI.

get_training_home

Remove an exercise entry from a workout. This discards the entry and its custom targets and notes.

remove_exercise_from_workout

Use this from the editor Save changes action to apply exactly the reviewed draft version. Rejects newer workout revisions. Retry the same proposal/version safely after a network failure.

apply_workout_proposal

Use this to save explicitly changed native training preferences. Units change display only; stored weights remain kilograms.

update_plugin_settings

Search the user's workouts, completed sessions and the exercise catalog. Returns result ids for use with fetch.

search

Use this when building a saved workout or finding catalog exercises matching available equipment or target muscles. Returns exercise IDs, equipment, muscles and default prescriptions. Use show_exercise_info for a user-facing demonstration. Not needed for general fitness definitions or medical advice.

list_exercises

Use this directly when the user asks about an exercise, asks how to do it, or wants form/instruction details. Pass exercise_id if known, otherwise pass exercise_query with the natural exercise name. Requests an exercise panel with an image and step-by-step instructions. The host controls visibility; a successful result does not prove it opened, so do not claim that it did. Benefits and common mistakes remain available for the accompanying text response.

show_exercise_info

Use this when the user asks to review their recorded training progress, workout frequency, volume, or logged weights. Summarizes recorded Simple Muscle sessions; report empty history honestly and do not infer progress from planned targets. Pass exercise_id if known, otherwise pass exercise_query when the user asks about one exercise by name. Renders a SimpleMuscle stats widget.

show_training_stats

Use this when the user asks what workouts they have, asks to see workouts, or wants a user-facing workout overview. When a SimpleMuscle workspace is already open, it refreshes automatically: do not call this tool after writes. Otherwise call at most once after every write finishes; never call it in parallel with workout writes. UI recovery must use get_workout_overview, which returns data without opening another view. Renders a compact SimpleMuscle widget with exercise images, targets and schedule labels.

show_workout_overview

Adapt the prescription of one exercise in a workout: set count, uniform targets (reps/weight/duration applied to every set), notes, or position. Only the provided fields change. Reducing set count removes trailing sets and their targets; uniform targets overwrite per-set values. For strength exercises, send reps and optionally weight_kg; omit duration_seconds. For cardio or stretching, send duration_seconds; omit reps and weight_kg. An open SimpleMuscle workspace refreshes automatically; do not open additional overview cards. Without an open workspace, call show_workout_overview once after all writes finish.

update_exercise_sets

Rename a workout, change its scheduled day, or archive/unarchive it.

update_workout

Use this when the user wants to view or adapt a saved workout, such as replacing exercises for available equipment or changing set targets. Opens the persistent workout plan editor; empty arguments show a workout picker. Edits are reviewed as drafts before saving. If the editor is already open, reuse its workspace context instead of opening another view.

open_workout_plan