| get_todays_weigh_insA | Fetch all body-composition / weight measurements for a single calendar day (defaults to today in America/Chicago or FITDAYS_TIMEZONE) in one call.
Returns date, timezone, count, has_weigh_in (boolean), latest (the most recent weigh-in for that day with full ext_data, or null if none), and weigh_ins (all weigh-ins for that day ordered newest first).
By default forces a fresh sync (refresh: true) and excludes deleted records (include_deleted: false) while including full ext_data (include_ext_data: true).
ext_data contains the measured person's context and FitDays reference values for interpreting the weight metrics. Treat these as informational rather than authoritative, and adjust them to the person's actual situation.
Context fields describe the person and measurement state, including age, height, sex (female or male), and onlyMeasureWeight (whether the record contains weight only).
Range and standard fields provide reference targets: Min and Max define the reference range, while Standard is the recommended value. They include body-fat mass, body-fat percentage, BMI, basal metabolic rate, bone mass, muscle mass, skeletal muscle mass, protein mass, water mass, and weight fields.
Control fields indicate the suggested adjustment toward the corresponding Standard value, including bfmControl (body-fat mass), ffmControl (fat-free mass), and weightControl (weight).
Fat-free-mass reference fields provide the recommended fat-free mass, including ffmStandard.
Index fields provide skeletal-muscle indexing, including smi (skeletal muscle index).
Classification fields describe body-composition status, including bodyScore, bodyType, and obesityDegree.
Target fields describe target body-composition values, including targetWeight, targetBodyfatMass, and targetSMMMass; unavailable target-mass values are null.
Device fields identify the source device, including deviceModelExt, deviceNameExt, and deviceSoftwareVer. |
| list_usersA | List the sub-users (people) registered under the FitDays account.
Each user has a unique and stable suid, used by other tools to query data for that user.
Returns a list where each entry contains nickname, sex (male or female, biological sex), birthday, height_cm, target_weight_kg (user-set target weight), suid, and uid (account uid). |
| list_devicesA | List the devices bound to the FitDays account.
Returns device_id (FitDays device identifier), name, model, mac (MAC address), and firmware_ver (firmware version) for each device. |
| get_weight_historyA | Return body-composition / weight measurements, optionally filtered by sub-user (suid) and time window.
Data is fetched lazily when no valid cache exists and stored in a global cache shared by all tools for 5 minutes; subsequent queries use that cached snapshot until it expires. Use refresh_sync if you are within the 5-minute cache window and fresher data is required.
Returns a list ordered newest first. Each measurement contains weight_kg, weight_lb, bmi, bfr_pct (body fat percentage), rom_pct (muscle percentage), rosm_pct (skeletal muscle percentage), vwc_pct (body water percentage), pp_pct (protein percentage), sfr_pct (subcutaneous fat percentage), uvi (visceral fat index), bm_kg (bone mass), bmr_kcal (basal metabolic rate), bodyage (body age), measured_at (ISO 8601 timestamp), measured_time (Unix-seconds timestamp), data_id, suid, uid, and is_deleted. Set include_ext_data: true to also return ext_data for each record.
ext_data contains the measured person's context and FitDays reference values for interpreting the weight metrics. Treat these as informational rather than authoritative, and adjust them to the person's actual situation.
Context fields describe the person and measurement state, including age, height, sex (female or male), and onlyMeasureWeight (whether the record contains weight only).
Range and standard fields provide reference targets: Min and Max define the reference range, while Standard is the recommended value. They include body-fat mass, body-fat percentage, BMI, basal metabolic rate, bone mass, muscle mass, skeletal muscle mass, protein mass, water mass, and weight fields.
Control fields indicate the suggested adjustment toward the corresponding Standard value, including bfmControl (body-fat mass), ffmControl (fat-free mass), and weightControl (weight).
Fat-free-mass reference fields provide the recommended fat-free mass, including ffmStandard.
Index fields provide skeletal-muscle indexing, including smi (skeletal muscle index).
Classification fields describe body-composition status, including bodyScore, bodyType, and obesityDegree.
Target fields describe target body-composition values, including targetWeight, targetBodyfatMass, and targetSMMMass; unavailable target-mass values are null.
Device fields identify the source device, including deviceModelExt, deviceNameExt, and deviceSoftwareVer.
By default includes tombstoned records (is_deleted: 1); set include_deleted: false to hide them. |
| get_latest_weightA | Return the most recent body-composition / weight measurement in the current global cache, optionally for a single sub-user (suid).
Data is fetched lazily when no valid cache exists and stored in a global cache shared by all tools for 5 minutes; subsequent queries use that cached snapshot until it expires. Use refresh_sync if you are within the 5-minute cache window and fresher data is required.
Returns exactly one measurement containing weight_kg, weight_lb, bmi, bfr_pct (body fat percentage), rom_pct (muscle percentage), rosm_pct (skeletal muscle percentage), vwc_pct (body water percentage), pp_pct (protein percentage), sfr_pct (subcutaneous fat percentage), uvi (visceral fat index), bm_kg (bone mass), bmr_kcal (basal metabolic rate), bodyage (body age), measured_at (ISO 8601 timestamp), measured_time (Unix-seconds timestamp), data_id, suid, uid, is_deleted, and ext_data, or null if no matching measurement exists.
ext_data contains the measured person's context and FitDays reference values for interpreting the weight metrics. Treat these as informational rather than authoritative, and adjust them to the person's actual situation.
Context fields describe the person and measurement state, including age, height, sex (female or male), and onlyMeasureWeight (whether the record contains weight only).
Range and standard fields provide reference targets: Min and Max define the reference range, while Standard is the recommended value. They include body-fat mass, body-fat percentage, BMI, basal metabolic rate, bone mass, muscle mass, skeletal muscle mass, protein mass, water mass, and weight fields.
Control fields indicate the suggested adjustment toward the corresponding Standard value, including bfmControl (body-fat mass), ffmControl (fat-free mass), and weightControl (weight).
Fat-free-mass reference fields provide the recommended fat-free mass, including ffmStandard.
Index fields provide skeletal-muscle indexing, including smi (skeletal muscle index).
Classification fields describe body-composition status, including bodyScore, bodyType, and obesityDegree.
Target fields describe target body-composition values, including targetWeight, targetBodyfatMass, and targetSMMMass; unavailable target-mass values are null.
Device fields identify the source device, including deviceModelExt, deviceNameExt, and deviceSoftwareVer.
By default ignores tombstoned records (is_deleted: 1). |
| refresh_syncA | Force-refresh the global FitDays cache shared by all tools.
FitDays data is loaded lazily: the first tool call that needs synchronized account data fetches a fresh snapshot and stores it in the global cache for 5 minutes.
Returns synchronized record counts for devices, users, height_records, and weight_records (active, deleted, total). |