FITAGE – Home Assistant integration for FITAGE/QNClouds smart scales

Share your Projects! Custom Integrations
1

Hi everyone,

I’d like to share FITAGE, a custom Home Assistant integration for FITAGE smart scales using the FITAGE/QNClouds cloud service.

The integration brings weight and body-composition measurements into Home Assistant and supports multiple user profiles.

FITAGE integration overview
FITAGE integration overview1344×550 31.6 KB

Features

  • Multiple FITAGE user profiles

  • Weight and BMI

  • Body fat and body water

  • Muscle, bone and protein measurements

  • Subcutaneous and visceral fat

  • Fat-free weight and body mass measurements

  • BMR, body age, score and heart rate

  • Profile goals and measurement assessments

  • Historical measurement synchronization

  • Server updates and deleted measurements

  • Exact original measurement timestamps

  • Restart-safe history synchronization

  • Optional Home Assistant long-term statistics

  • Stable entity and device identities

Historical measurements

Since v1.4, FITAGE can synchronize existing historical measurements from FITAGE/QNClouds.

Raw historical records are stored privately inside Home Assistant, with a separate history and synchronization cursor for every profile.

The latest sensor value is determined from the actual measurement timestamp rather than relying on the order returned by the server.

FITAGE historical dashboard
FITAGE historical dashboard1344×455 30.2 KB

Exact history is available through admin-only websocket commands. Optional external statistics can be enabled for standard Home Assistant graphs and compatible dashboard cards.

Statistics use the last measurement of each UTC hour. Exact timestamps and all individual measurements remain available in the private raw history.

Privacy

Importing historical measurements into Home Assistant Recorder is optional and disabled by default.

Enabling it stores derived health measurements in Recorder for long-term graphs. Disabling the option stops future imports but does not silently remove statistics that have already been imported.

FITAGE statistics privacy option
FITAGE statistics privacy option1400×655 56.4 KB

Installation with HACS

Until FITAGE is included in the default HACS catalogue:

  1. Open HACS.

  2. Open the menu and select Custom repositories.

  3. Add:

    https://github.com/lampje25/ha-fitage

  4. Select Integration as the repository type.

  5. Install FITAGE.

  6. Restart Home Assistant.

  7. Go to Settings → Devices & services → Add integration and search for FITAGE.

The request for inclusion in the default HACS catalogue is currently pending:

HACS/default PR #10599

Requirements

  • Home Assistant 2025.12.0 or newer

  • A working FITAGE account

  • Internet access from Home Assistant to the FITAGE/QNClouds cloud service

Links

Feedback and compatibility reports are welcome. If you encounter a problem, please open a GitHub issue without including passwords, access tokens or personal health data.

This is an independent community custom integration and is not an official integration from Home Assistant, FITAGE or QNClouds.