mi-fitness-mcp

[](https://github.com/kubulashvili/mi-fitness-mcp/actions/workflows/ci.yml) [](https://github.com/kubulashvili/mi-fitness-mcp/releases) [](https://github.com/kubulashvili/mi-fitness-mcp/blob/main/LICENSE)

MCP server for Mi Fitness data.

This project provides a local SQLite-backed MCP server for Mi Fitness cloud data.

Confirmed with the current cloud flow:

• daily activity
• steps
• distance
• active calories
• heart rate
• body measurements
• weight
• BMI
• fat, water, bone, and muscle metrics
• visceral fat
• basal metabolism

Not yet confirmed with the current Xiaomi cloud endpoint:

• sleep
• workouts

python -m venv .venv
source .venv/bin/activate
pip install -e '.[dev]'

You need:

• userId
• passToken

Typical flow:

1. Open https://account.xiaomi.com
2. Sign in to your Xiaomi account
3. Open browser DevTools
4. Inspect cookies for account.xiaomi.com
5. Copy userId and passToken

Configure the server:

mi-fitness-mcp setup --mode mi_fitness_cloud --user-id "<userId>" --pass-token "<passToken>" --region ru
mi-fitness-mcp doctor

For local endpoint exploration there is also a probe script:

python probe_mifitness.py --user-id "<userId>" --pass-token "<passToken>"

mi-fitness-mcp sync --start-date 2025-04-01 --end-date 2025-05-31
mi-fitness-mcp serve

Example Claude Desktop config:

{
  "mcpServers": {
    "mi-fitness": {
      "command": "mi-fitness-mcp",
      "args": ["serve"]
    }
  }
}

• Show my daily activity for the last 14 days
• How has my resting heart rate changed this month?
• `Summarize my latest bo