activate_workout_plan
ClaudeMakes one of the patient's saved workout plans (plan_id, an id from get_plan_library) the active plan, the one the Well app's Gym Coach trains from. The plan that was active moves to the plan library; nothing is deleted. The answer carries the plan's id and whether it was already the active plan.
create_workout_plan
ClaudeSaves a workout plan as the patient's new active plan in the Well app's Gym Coach, replacing the plan that is active now (that one moves to the plan library). The plan is a name, a program type, a rationale (one or two sentences, in the patient's language, on why the plan fits them, shown with the plan in the app) and 1-7 training days, each with 1-12 exercises from the exercise catalog (search_exercises and get_muscle_groups list them; an id that is not in the catalog is refused). Per exercise: warmup_sets, working_sets and target_reps (text such as "8-12"), and an optional intensity (such as "RIR 2"). A day's weekday is 1 = Sunday to 7 = Saturday, distinct across days; day_label_ar is the day's Arabic name. The answer carries the new plan's id and its days per week.
delete_meal_entries
ClaudeDeletes entries from the patient's food diary in the Well app, picked by their entry_ids (1-20; get_meal_log and get_nutrition_today list each entry's id). Deleting is permanent and cannot be undone; it is meant for entries the patient named or approved for deletion. Only entries dated in the last 30 days (Riyadh time) are deleted. The answer lists each deleted entry (food, meal, date, calories), the ids that were not found and the ids of entries older than 30 days, which stay. An entry that is already gone is reported as not found, so repeating the call deletes nothing more.
edit_meal_entry
ClaudeChanges one entry in the patient's food diary in the Well app, picked by its entry_id (get_meal_log and get_nutrition_today list each entry's id). Any of food_name, portion_grams, calories, protein_g, carbs_g, fat_g (grams), meal_type (breakfast, lunch, dinner or snacks) and date (YYYY-MM-DD) can be given, at least one, within log_meal's bounds. When the portion changes, the calories and macros not given are scaled in proportion to the new portion; numbers that are given are stored as given. Only entries dated in the last 30 days (Riyadh time) can be changed, and a new date stays within those days. The answer shows each changed field before and after.
find_live_care
ClaudeOn-demand doctor consultations at Well (video or text chat, no appointment): whether a doctor is available right now, how many doctors are online, and each consultation type on offer with its price in SAR and what it includes.
get_activity_today
ClaudeToday's step count and calories burned (kcal), as last synced from the Well app or a paired band. Active minutes are not synced per day and are returned as null. timezone (IANA name, default Asia/Riyadh) sets which day is today.
get_appointment
ClaudeOne of the patient's appointments in Well, by kind (home_care, doctor or live_care) and the id from list_appointments. Home-care visit: reference, status, times, services, provider roles, the amount due in SAR, payment plan and review state. Doctor appointment: status, times, specialty, doctor, whether it can be joined, amount in SAR. Live-care consultation: reference, status, mode, clinician, start and end, end reason, amount in SAR and the follow-up the doctor suggested. An appointment that is not the patient's is reported as not found.
get_bioage
ClaudeThe patient's biological age exactly as the Well app's hero screen shows it (a 7-day rolling median of daily readings), with the full breakdown: the latest daily composite, each contributing sub-model age (fitness, PhenoAge, wearable pace) in years, the confidence band, and the raw components and pillar contributions behind the number.
get_care_plan
ClaudeA care plan a Well doctor proposed to the patient: name, status, prescriber, proposed and expiry dates, total in SAR, the lines it includes (kind, whether selected, how each is delivered) and its next 20 scheduled items that are not done. The plan with the given plan_id, otherwise the newest proposed, accepted or converted one; no current plan is reported as plan: null.
get_consult_summary
ClaudeWhat the Well doctor recorded for one of the patient's consultations, by consult_id (the id of a live_care item from list_appointments): whether a prescription was issued and the note signed, the diagnoses (text, ICD-10 code, verification status), the prescriptions in force (name, strength, frequency, duration), the sections of the doctor's note and the name of a care plan the doctor recommended. A consultation that cannot be found is reported as not found.
get_current_plan
ClaudeThe patient's active workout plan in full: its name and program type, and every training day with its exercises (days), plus today, the session for today (null on a rest day), as last synced from the Well app. A day's weekday is 1 = Sunday to 7 = Saturday. timezone (IANA name, default Asia/Riyadh) sets which day is today.
get_daily_summary
ClaudeThe patient's day in one answer, as last synced from the Well app: last night's sleep, today's recovery, strain, vitals, steps and calories, today's food diary against goals, the last 3 workouts, the streak, the latest biological age and, when the patient shared their care data, appointments in the next 7 days. Each section has the same fields as its own tool (get_sleep_summary, get_recovery, get_strain, get_vitals_today, get_activity_today, get_nutrition_today, get_recent_workouts, get_streak, get_bioage, list_appointments); a section that could not be read holds error instead, and a section the patient did not share is left out. timezone (IANA name, default Asia/Riyadh) sets which day is today.
get_doctor_slots
ClaudeFree appointment times for one doctor in Well's marketplace (a practitioner_id from search_doctors) within a window of up to 14 days (default: the next 7 days), with the doctor's name and consultation fee in SAR. Times are ISO 8601; dates are Riyadh days.
get_exercise_info
ClaudeOne exercise from the exercise catalog by its exercise_id: bilingual name (Arabic/English), muscle groups, equipment, category and difficulty (1 = beginner, 2 = intermediate, 3 = advanced, or null if unrated).
get_health_content
ClaudeHealth education from Well: articles on understanding blood sugar (title, summary, full text), daily diabetes tips, health plans Well offers (title, summary, price in SAR and its period), or short educational videos (title, description, length in seconds).
get_home_care_slots
ClaudeFree home-care visit windows over the next 1–14 days (default 7) at the patient's default address: whether the address is inside Well's home-care service area and, if so, each day's morning, afternoon and evening windows (ISO 8601; days are Riyadh days). Optionally limited to the given service ids from list_home_care_services.
get_meal_log
ClaudeThe food diary entries (calories; protein, carbs and fat in grams; portion in grams) logged on a given date (YYYY-MM-DD), grouped by meal type, as last synced from the Well app. Each entry carries its entry_id, the id edit_meal_entry and delete_meal_entries take.
get_medical_history
ClaudeA summary of the patient's medical records in Well, one entry per section (labs, medications, vital_signs, immunizations, problems, allergies, imaging, visits): the section's title, how many entries it holds, whether Well read it completely, and its 3 most recent entries (name, date, and any measured value with its unit, flag and reference range as recorded); plus how many downloadable documents the records hold. Mental-health records are not included and not counted.
get_medical_record
ClaudeOne of the patient's medical records in Well, by kind and the id from get_medical_records. Lab report: title, issue time, status, whether it was corrected, each result (name, value, unit, reference range and the abnormal mark as issued) and the report's conclusion. Prescription: title, issue time, status, prescriber and each medication (name, strength, form, route, dose, frequency, duration, whether as needed, instructions). Imaging report: title, issue time, modality, body site, findings, conclusion and recommendation. Sick leave: start and end dates, number of days, issue time, status and practitioner. A record that is not in the patient's records, or is a mental-health record, is reported as not found.
get_medical_records
ClaudeThe entries of one section of the patient's medical records in Well (labs, medications, vital_signs, immunizations, problems, allergies, imaging, visits) or their sick leaves, newest first, up to limit (1–50, default 20): id and kind (lab, prescription, imaging and sick_leave as get_medical_record takes them; entry otherwise), name, date, any measured value with its unit, flag and reference range as recorded, and status; sick leaves also carry their start and end dates and number of days. Mental-health records are not included.
get_muscle_groups
ClaudeThe full vocabulary of valid muscle values for filtering exercises, each with Arabic and English labels.
get_my_profile
ClaudeThe signed-in patient's own Well profile summary: first name, age, sex, nationality and whether their identity is verified.
get_nutrition_history
ClaudeOne row per day with logged food, newest first: daily totals (calories; protein, carbs and fat in grams; items_logged) alongside that day's goal targets, as last synced from the Well app. Days with nothing logged are omitted. days sets how far back to look (1-90, default 14); timezone (IANA name, default Asia/Riyadh) anchors today with the app's 4 AM nutrition-day rollover.
get_nutrition_today
ClaudeToday's food diary: meals logged so far grouped by type (breakfast/lunch/dinner/snacks), with running totals (calories; protein, carbs and fat in grams) against the patient's daily goals, as last synced from the Well app. Each entry carries its entry_id, the id edit_meal_entry and delete_meal_entries take. Today is the nutrition day in timezone (IANA name, default Asia/Riyadh); before 4 AM it is still the previous calendar day, matching the app's diary.
get_personal_records
ClaudeThe heaviest working set (weight in kg, reps) per exercise across the patient's latest 200 completed workouts, as last synced from the Well app.
get_plan_library
ClaudeThe patient's non-expired workout plans, active and past, newest created first (at most 50), as last synced from the Well app.
get_progress_summary
ClaudeWeekly completed-session counts and total tonnage (kg) grouped by ISO week, as last synced from the Well app. weeks sets how many weeks back to include (1-26, default 8).
get_readings
ClaudeThe patient's readings of one measure in Well (blood_pressure, glucose, heart_rate, weight, temperature or spo2) over the last 1–90 days (default 30), newest first, at most 200: the time, value and unit (systolic and diastolic for blood pressure), the interpretation flag Well recorded with the reading (null when it recorded none) and where the reading came from. Every answer carries the emergency number line.
get_recent_workouts
ClaudeThe patient's most recent completed workout sessions, newest first, each with its exercises, sets (weight in kg, reps) and total tonnage (kg), as last synced from the Well app. limit caps how many sessions are returned (1-50, default 5).
get_recovery
ClaudeThe patient's latest recovery score (0-100) with the HRV, resting heart rate and sleep-score signals behind it and the coaching message, as last synced from the Well app. WHOOP's numbers appear in a separate whoop block only when the patient has connected WHOOP and allowed AI access to their WHOOP data in the Well app. They are WHOOP's own scores on WHOOP's scales (recovery and sleep performance out of 100, day strain out of 21), labelled data by WHOOP, never recomputed by Well and never compared against Well's scores; each belongs to the WHOOP day in its day.
get_sleep_summary
ClaudeLast night's sleep (score, duration and stage minutes) plus a daily history, newest first, as last synced from the Well app. days sets how many days of history to include (1-30, default 7). WHOOP's numbers appear in a separate whoop block only when the patient has connected WHOOP and allowed AI access to their WHOOP data in the Well app. They are WHOOP's own scores on WHOOP's scales (recovery and sleep performance out of 100, day strain out of 21), labelled data by WHOOP, never recomputed by Well and never compared against Well's scores; each belongs to the WHOOP day in its day.
get_strain
ClaudeThe patient's latest strain score on the 0-21 scale, as last synced from the Well app. WHOOP's numbers appear in a separate whoop block only when the patient has connected WHOOP and allowed AI access to their WHOOP data in the Well app. They are WHOOP's own scores on WHOOP's scales (recovery and sleep performance out of 100, day strain out of 21), labelled data by WHOOP, never recomputed by Well and never compared against Well's scores; each belongs to the WHOOP day in its day.
get_streak
ClaudeThe patient's current streak. streak_days is the consecutive-day streak the Well app shows on its home screen: a day counts when at least one meal was logged or a workout was completed, and a day not yet logged today does not break it. One automatic streak freeze per rolling 7 days bridges a single missed day without counting it (streak_freeze). training_streak_days counts consecutive days with a completed workout only. timezone (IANA name, default Asia/Riyadh) sets which day is today.
get_vitals_today
ClaudeThe patient's latest vitals: HRV (ms), resting heart rate (bpm), respiratory rate (breaths/min), SpO2 (%), energy bank and stress score, as last synced from the Well app. WHOOP's numbers appear in a separate whoop block only when the patient has connected WHOOP and allowed AI access to their WHOOP data in the Well app. They are WHOOP's own scores on WHOOP's scales (recovery and sleep performance out of 100, day strain out of 21), labelled data by WHOOP, never recomputed by Well and never compared against Well's scores; each belongs to the WHOOP day in its day.
get_workout_detail
ClaudeOne workout session in full detail (exercises, sets in kg and reps, tonnage) by its session_id (uuid), as last synced from the Well app.
list_appointments
ClaudeThe patient's own appointments in Well across home-care visits, live-care consultations and doctor appointments, upcoming, past or both within 1–180 days of today: id and kind (as get_appointment takes them), status, start and end times, title, clinician, reference, whether it can be joined now, and, for home-care visits, whether it can be cancelled in the Well app. Appointments booked only for family members are not listed; family_items counts them.
list_home_care_services
ClaudeHome care services Well delivers at home in Saudi Arabia (such as IV drips, nurse, doctor and physiotherapy visits, and blood draws), grouped by category (with its id): name, short description, price and usual price in SAR, duration in minutes, who delivers it, and whether a prescription is needed.
list_specialties
ClaudeMedical specialties in Well's online doctor marketplace in Saudi Arabia: each specialty's code, its name, and how many doctors are listed under it.
list_subscriptions
ClaudeThe care programs the patient is enrolled in at Well: name, status, end of the current period, whether it renews automatically, whether it ends at the period end, net price in SAR and the usage (used of total) of each included service.
log_meal
ClaudeAdds a meal to the patient's food diary in the Well app: 1-20 items, each a food name with its serving in grams and the calories, protein, carbs and fat (grams) of that serving. The numbers are the caller's estimates and are stored as given. The meal is filed under meal_type (breakfast, lunch, dinner or snacks; default snacks) on today's nutrition day in timezone (IANA name, default Asia/Riyadh); before 4 AM that is still the previous calendar day, as in the app's diary. The answer lists what was logged with its totals.
search_doctors
ClaudeDoctors listed in Well's online marketplace, optionally within one specialty (a code from list_specialties): name, specialty, gender, spoken languages, years of experience, consultation fee in SAR, next available time, whether available now, rating and a short bio.
search_exercises
ClaudeExercises from the exercise catalog matching a name, muscle group, equipment and/or difficulty, at most 25 per call. Muscle values: chest, back, shoulders, biceps, triceps, forearms, quads, quadriceps, hamstrings, glutes, calves, abs, obliques, lower_back, traps, neck, inner_thighs, rotator_cuff, full_body, cardio, mobility, lats. Difficulty: beginner, intermediate, advanced.
update_workout_plan
ClaudeReplaces the contents of one of the patient's workout plans in the Well app's Gym Coach, in place: the plan keeps its id, so the workouts logged against it stay linked (create_workout_plan saves a new plan instead). The plan is plan_id (an id from get_plan_library), or the active plan when it is left out. The plan sent is the complete revised plan, the same shape as create_workout_plan's (get_current_plan and get_plan_library show the current one); days and exercises left out of it are removed. rationale is one or two sentences, in the patient's language, on why the plan fits them, shown with the plan in the app. Exercise ids come from the exercise catalog (search_exercises); a day's weekday is 1 = Sunday to 7 = Saturday, distinct across days. The answer carries the plan's id and whether it is the active plan.