mi-fitness-health/README.md

Mi Fitness MCP

MCP server for Mi Fitness data.

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

Current data coverage

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

Install

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

Setup

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>"

Use

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

MCP client config

Example Claude Desktop config:

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

Example prompts

• Show my daily activity for the last 14 days
• How has my resting heart rate changed this month?
• Summarize my latest body measurements
• Sync my latest Mi Fitness data

Commands

mi-fitness-mcp --help
mi-fitness-mcp setup --help
mi-fitness-mcp doctor
mi-fitness-mcp sync --help
mi-fitness-mcp serve

Development

pytest
python -m build

Troubleshooting

• Connection: failed
  • verify userId and passToken
  • verify region, usually ru
• Credentials not found
  • run setup again
• sync returns no data
  • try another date range
  • verify that the data actually exists in Mi Fitness cloud

Security

• passToken is stored via the system keyring
• do not commit .env, local config files, or real credentials
• rotate tokens if they were pasted into chats or shell history

Disclaimer

This is an unofficial project and is not affiliated with Xiaomi.