Gravl

Permanently deletes a saved workout template. Fails if a custom split still uses the template: remove it from the split first. Irreversible: only call it after the user explicitly confirms the specific template.

delete_workout_template

Fetches the account (name, username, subscription status), the body profile (gender, height, body weight), and all editable settings groups in one response: user, workout, warmup, rest time, appearance, and training mode. Read it before you edit settings or diagnose a problem. Custom splits and gym profiles have their own list tools.

get_all_settings

Reads the user's weight and body measurements over a range of up to 92 days: weigh-ins, the smoothed trend weight the app judges progress on, the change over the range and per week, and girths and body fat. Weights are in kg and girths in cm; convert for an imperial user.

get_body_metrics

Fetches one custom muscle split by external id.

get_custom_split

Fetches one equipment item by numeric id.

get_equipment

Fetches one exercise's full detail by numeric id: description, muscles, equipment, movement, difficulty, importance, and whether it supports incline, steps, or added weight.

get_exercise

Returns one exercise's recent sessions, newest first, with every logged set, top set, estimated 1RM, session volume, set count, weekly frequency, and rep PRs. Resolve the exercise id first.

get_exercise_history

Reads the user's Gravl Macros food log for one day: each entry with its id, time, portion, calories and macros, the day's totals, its calorie and macro targets, and what is left. Use it to answer how much the user ate or has left, and to find an entry's id before deleting it.

get_food_log

Reads the user's memory file: short facts that Gravl assistants saved about the user in earlier conversations (preferences, goals, schedule, constraints), each with an id. Read it at the start of a conversation and before you save, update, or delete a memory. Live account data (settings, workouts, records) wins over a memory that disagrees with it.

get_memory

Reads the user's Gravl Macros setup: current and goal weight, unit system (metric or imperial), daily calorie and macro targets, and the active program's goal and weekly change. Read it before giving advice, and use its unitSystem when you talk about weight, measurements or water.

get_nutrition_profile

Summarizes the user's eating over a range of up to 92 days: average calories and macros, days logged, days the calorie target was met, and each logged day's totals against its target. Use it for "how did my week go" questions; use get_food_log for one day's entries.

get_nutrition_summary

Returns readable id/name options for every enum field (goals, levels, Variety Level, muscles, weight units, workout types, set types, session types, ...). Call it once before sending numeric ids in a write tool.

get_mcp_options

Lists exercises Gravl considers similar to the given exercise id. Use it to suggest swaps or alternatives for a movement the user cannot or does not want to do.

get_related_exercises

Returns the user's weekly Gravl strength scores, newest week first, with total and per-muscle changes. Call it with no arguments for the current score: it needs no date range, so never ask the user for one. Add fromWeek/toWeek or limit for trends and comparisons. A null total means the overall score is not unlocked yet; use the muscle scores instead. Exercise-level records are omitted unless includeExercises is true or exerciseId is set.

get_strength_scores

Lists Gravl's built-in system training splits: externalId, name, description, supported days per week, and session names. Use it to name the selected system split, or to pick a systemMuscleSplitExternalId before select_training_mode.

get_system_splits

Summarizes a training window: weekly workouts, working sets and volume, comparison with the preceding window, muscle balance, and the biggest exercise improvements and declines. Defaults to the last 12 weeks. Prefer it over fetching many full workouts.

get_training_summary

Reads how much water the user logged on one day, against their daily water target, and whether water can be logged for that day.

get_water

Fetches one workout with its exercise and set details. Get workoutExternalId from list_workouts. Ids from public share links (app.gravl.ai/quick-workout/public/...) are share-snapshot ids and do not resolve here.

get_workout

Reads the user's upcoming workouts, next one first: plan.revision (send it as expectedRevision on every plan write), aiCoachEnabled, lastPlannedDate, and each workout's externalId, scheduledDate, kind and exercises with sets. A set without a weight is calculated by the user's Gravl app. exerciseNames maps every exerciseId to its name; guided workouts include the session content.

get_workout_plan

Fetches one saved workout template by external id, with its exercises and sets.

get_workout_template

Lists the user's body measurements (weight, body fat, girths), newest first, including those logged in Gravl Macros. Every row is in the user's unit: weightUnit kg means cm for girths, lb means inches. isExternal is true for readings that did not come from Gravl Workouts (Gravl Macros, health apps).

list_measurements

Lists the user's custom muscle splits and their sessions.

list_custom_splits

Lists every Gravl equipment option with its id and name. Use it to translate the user's equipmentIds (get_all_settings) into names, or to pick an equipmentId filter for list_exercises.

list_equipment

Browses Gravl's exercise library (catalog plus the user's custom exercises) by muscle, submuscle, equipment, type, or category. It is the only source of exercise recommendations: never recommend an exercise you have not seen in a result. To turn exercise names into ids, use resolve_exercises instead. There is no difficulty filter: each result carries a difficulty array, so filter for the user's level yourself. Send at least one filter and a small limit.

list_exercises

Lists Gravl's guided sessions (timed hybrid and conditioning sessions with sections, rounds and rests) that can go in the workout plan: splitName, sessionExternalId, name, estimatedMinutes and section names. Use a sessionExternalId as guidedSessionExternalId in upsert_planned_workout.

list_guided_sessions

Lists the user's gym profiles and the equipment selected in each. Read it before you recommend exercises for a specific gym.

list_gym_profiles

Lists the user's own Gravl Macros foods: saved, recent and custom foods with the serving they usually log, and their saved meals. Check it before search_foods when the user names something they eat often ("my usual protein shake"). Recipes are listed for reference only.

list_my_foods

Lists the user's personal records (1RM, max weight, max volume, max reps, duration, distance), optionally for one exercise. Use it to ground weight suggestions in what the user actually lifts. Pass exerciseId when you care about one movement: the unfiltered list covers the whole history.

list_personal_records

Lists the user's routines (meals they repeat on set weekdays at a set time) with their foods and totals, and for the given day whether each due routine is pending, logged or skipped.

list_routines

Lists the user's saved workout templates with external ids, names, descriptions, and exercise counts. A custom-split session with sessionType=1 points at a template's externalId.

list_workout_templates

Lists completed workouts, latest first, with paging and filters: date range, a contained exercise, a trained muscle, workout type, or a name substring. Call it without filters for recent workouts. Includes workouts synced from other platforms (Apple Health, Strava, ...) unless filtered via source.

list_workouts

Logs one food item, or one saved meal, to the user's Gravl Macros day. Prefer the user's own food from list_my_foods (foodId) or a catalog food from search_foods (source and externalId), with the portion the user said; use grams only when the user gave a weight, and quickAdd only when nothing matches. Log each item of a meal with its own call and its own idempotencyKey. Returns the updated day.

log_food

Logs body measurements for a day: body fat percent and girths (neck, shoulder, chest, bicep, forearm, waist, abdomen, glutes, thigh, calf). Only the measurements sent change; the rest of that day stays.

log_measurements

Answers one of the user's routines for a day: log adds its foods to the day as they are saved, skip marks it as not eaten. Take the routine id from list_routines. Logging needs Gravl Macros Pro.

log_routine

Adds water the user drank to a day. Each call adds to the day's total. Returns the day's water.

log_water

Logs the user's weight for a day. One reading per day: logging again the same day replaces it, as in the app.

log_weight

Adds a workout to the user's plan, or replaces the planned workout with the same externalId. Only works while AI Coach is on (select_training_mode aiCoach, after the user agrees). A dated workout goes in date order; position 0 makes it the next workout. Omit set weights to let Gravl calculate them. Resolve exercise ids with resolve_exercises first. Fails when expectedRevision is stale: call get_workout_plan and retry. Returns the updated plan.

upsert_planned_workout

Removes one upcoming workout from the user's plan (not a logged workout). Only works while AI Coach is on. Fails when expectedRevision is stale: call get_workout_plan and retry.

remove_planned_workout

Full-replaces every session in a custom split with the list you send, so the desired final state must be explicit. Read the split first.

replace_custom_split_sessions

Full-replaces an existing workout template's name, description, and exercises with what you send, so the desired final state must be explicit. Read the template first with get_workout_template.

replace_workout_template