# mihealth-api: reconstructing Mi Fitness health-data access

> mihealth-api reconstructs access to personal Mi Fitness health data from the com.mi.health client API. Its Python client implements session handling and encrypted requests, synchronizes records into SQLite, and exposes local HTTP queries and a dashboard; API notes document endpoint and field behavior.

- Type: Case study
- Targets: App · Protocol
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-06
- Added to the catalog: 2026-11-08
- Original resource: <https://github.com/Aaron-gx/mihealth-api>
- Primary source: <https://github.com/Aaron-gx/mihealth-api/blob/05edd1308025795e124f8958b20f8408c41b1c82/README.md>
- Catalog page: <https://awesomerea.org/resources/mihealth-api-case/>
- Record JSON: <https://awesomerea.org/resources/mihealth-api-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/mihealth-api-case/index.md)

## Requirements & limits

- **Prerequisites:** Access to the user's own Mi Fitness account and valid session credentials.
- **Prerequisites:** Python 3.9 or later; device-based credential import requires a logged-in rooted device or emulator.
- **Limits:** The author's account had no GPS route or diet records, and route-file download was unavailable.
- **License:** MIT license.

## Primary sources

1. <https://github.com/Aaron-gx/mihealth-api/blob/05edd1308025795e124f8958b20f8408c41b1c82/README.md>
2. <https://github.com/Aaron-gx/mihealth-api/blob/05edd1308025795e124f8958b20f8408c41b1c82/API.md>

## More in Apps

- [garmin-proto-lab: reconstructing Garmin watch communication](https://awesomerea.org/resources/garmin-proto-lab-case/index.md) · Case study
- [Dorado: reconstructing a Zune HD application runtime](https://awesomerea.org/resources/dorado-emu-case/index.md) · Case study
- [eJay: static recompilation of the Dance eJay audio engines](https://awesomerea.org/resources/ejay-static-recompilation-case/index.md) · Case study
- [vclights: reconstructing VC-BLELIGHT lamp commands](https://awesomerea.org/resources/vclights-case/index.md) · Case study
- [ilo2ctl: rebuilding the HP iLO 2 remote console and controls](https://awesomerea.org/resources/ilo2ctl-case/index.md) · Case study
- [gpcli: reconstructing MyGP subscriber app API flows](https://awesomerea.org/resources/gpcli-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.