mifit MCP server

mifit

Read your own Mi Fitness (小米运动健康) data from the Xiaomi cloud: a small Python library, a command-line tool and an MCP server for AI assistants.

The Mi Fitness app syncs your steps, heart rate, sleep and more to the Xiaomi cloud, but Xiaomi offers no public API for individuals. mifit signs in to your own account by QR code, reads that synced data and returns it as JSON or as Python objects, so you can build on it.

Unofficial. Not affiliated with, endorsed by or supported by Xiaomi. See Disclaimer.

What it reads today

| Domain | What you get | records type | Checked against the app | |---|---|---|---| | steps | steps and distance per day | StepRecord | yes | | heart_rate | raw heart-rate samples | HeartRatePoint | yes | | heart_rate_daily | heart rate per day: average, maximum, minimum, resting | HeartRateDailySummary | yes | | consumption | calories per day: resting, active, intake, total | ConsumptionRecord | yes | | sleep | sleep per day: totals, stage minutes, sessions with their stage timeline | SleepRecord → SleepSession → SleepStage | yes; the sleep score could not be checked and is in raw only | | workouts | one entry per workout: start and end, sport, duration, distance, active and total calories, average and maximum heart rate, steps | Workout | yes | | workout_detail | per workout (outdoor runs and rides): per-second samples (heart rate, cumulative distance and steps, cadence, pace or speed) and the GPS track | WorkoutDetail → WorkoutSample / TrackPoint | yes (one outdoor run, one ride); altitude is in raw only: the run's was a few metres off the app's | | spo2_daily | blood oxygen (SpO2) per day: average, maximum, minimum | Spo2DailySummary | yes | | spo2 | raw SpO2 readings | Spo2Point | yes | | stress_daily | stress level per day: average, highest, lowest, and minutes in each stress band (relaxed, mild, moderate, severe) | StressDailySummary | yes | | activity_daily | activity per day, as on the app's 活力指标 page: activity count (活动次数), activity minutes (活动时长), active calories (卡路里) | ActivityDailySummary | yes | | weight | weight entries: time, weight, BMI (body composition in raw only) | WeightRecord | yes; body composition could not be checked and is in raw only | | profile (its own command: mifit profile) | height, weight, daily step, calorie and activity-time goals | UserProfile | yes | | raw (CLI: mifit raw; Python: client.raw, raw_window, daily_report) | the rows of any fitness-data or daily-report key, as the service sends them | none: the service's rows, uninterpreted | not applicable: nothing is interpreted |

"Checked against the app" means the values were compared with what the Mi Fitness app shows, on one real account (China region, UTC+8). More is planned. Meanwhile, mifit raw (in Python raw_window and daily_report) returns the rows of any other key of the fitness-data or (with --daily) daily-report endpoint, uninterpreted.

What changed in each version, breaking changes included, is in CHANGELOG.md.

Install

Requires Python 3.12 or later; uv installs one for you if needed.

uv tool install mifit     # recommended: its own environment, `mifit` on your PATH
pipx install mifit        # the same, with pipx
pip install mifit         # into the current environment, to use it as a library

Upgrade: uv tool upgrade mifit (or pipx upgrade mifit, pip install -U mifit).

Log in

mifit login