mifit
Read your own Mi Fitness sleep, heart rate, steps and workouts from an AI assistant
- Platforms
- CLI, self-hosted, API
- Runs
- Locally or Remotely
- Version
- 0.4.0
- Listing updated
- 4 days ago
Similar MCP servers
About mifit
mifit is an MCP server for health and science. It can run locally on your machine or as a hosted remote server.
Xiaomi offers no public API for individuals, so this project signs in to your own Mi Fitness account by QR code and reads the data the app has already synced to the Xiaomi cloud. The same code ships as a Python library, a command-line tool and an MCP server.
The README lists the data domains it reads: steps, raw and daily heart rate, calories, sleep with stage timelines, workouts with per-second detail for outdoor runs and rides, blood oxygen, stress, activity, weight and the profile. Values were compared with the app on one real account in the China region, and body composition and the sleep score are only available as raw rows.
The server runs locally over stdio and only reads health data. GPS routes are off unless you start it with a flag, and a session file in your home folder holds a token that the README warns reaches your whole Xiaomi account, so it should be treated like a password. It is unofficial and not affiliated with Xiaomi.
Install
Run in a terminal
claude mcp add mifit -- uvx mifitAdd to claude_desktop_config.json
{
"mcpServers": {
"mifit": {
"command": "uvx",
"args": [
"mifit"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mifit": {
"command": "uvx",
"args": [
"mifit"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mifit": {
"type": "stdio",
"command": "uvx",
"args": [
"mifit"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mifit": {
"command": "uvx",
"args": [
"mifit"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mifit": {
"command": "uvx",
"args": [
"mifit"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (4)
Taken from the project documentation; the running server may differ.
- get_status
- Shows today's date, time zone, login state and GPS setting.
- get_steps
- Reads steps and distance per day.
- get_calories
- Reads daily calories: resting, active, intake and total.
- login_start
- Starts a login and returns a QR code to scan.
What it does
- Broad health coverage
- Reads steps, heart rate, calories, sleep, workouts, SpO2, stress, activity and weight.
- QR-code login
- Signs in by scanning a QR code; your password never passes through the tool.
- GPS off by default
- Workout routes are returned only when started with an allow-GPS option.
- Raw data access
- A raw command returns uninterpreted rows for keys it does not model.
- Library and CLI too
- The same reader is usable from Python or the command line.
- Claude Desktop bundle
- A one-click .mcpb extension is published with each release.
Good for
- Ask how you slept last week
- Compare resting heart rate across a month
- Export workout history as JSON
- Review daily stress bands
- Pull weight and BMI entries into a script
Pricing
Pricing unknown
Licence and pricing not published.
mifit FAQ
Is it official?
No. The README says it is unofficial and not affiliated with or supported by Xiaomi.
Where does my login stay?
In a session file under ~/.mifit on your computer; results of tool calls still go to your assistant's model provider.
Does it change my data?
No, it only reads health data; the login tools save a new session locally.
Does it share GPS tracks?
Only if started with --allow-gps and the assistant asks for a route.
How do I add mifit to Claude Code?
Run this command in your terminal: claude mcp add mifit -- uvx mifit
What are the best alternatives to mifit?
The closest alternatives to mifit are Mi Fitness Data Bridge, Metrics Nest, Health Access MCP, HealthAPI and Memory.fit.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.