Zepp2Hass - Connect your Amazfit/Zepp Watch to Home Assistant!

Share your Projects! Custom Integrations
1

Hi everyone! :wave:

I’m excited to share a project I’ve been working on: Zepp2Hass!

:question: The Problem

If you own an Amazfit or Zepp smartwatch (like the T-Rex, GTR 4, Balance, Cheetah, etc.), you might have noticed that getting your health and activity data into Home Assistant is not possible. I wanted a way to push data directly and locally from my watch to Home Assistant.

:bulb: The Solution

Zepp2Hass is a two-part solution:

  1. A Home Assistant Custom Integration (available via HACS).
  2. A Zepp OS Watch App (available independently).

The watch app sends your data directly to a local webhook in Home Assistant. No cloud delays, no middleware!

:sparkles: Key Features

  • :satellite: Real-time Data: Pushes heart rate, steps, battery level, and more directly to HA.
  • :battery: Battery Efficient: Configurable update intervals (1-5 mins) to balance data freshness and battery life.
  • :bar_chart: Comprehensive Sensors:
    • Health: Heart Rate (last, resting, max), SpO2, Stress, Body Temp.
    • Activity: Steps, Calories, Distance, Stand count.
    • Sleep: Sleep score, duration, deep sleep, sleep stage times.
    • Device: Battery level, screen status, device info.
  • :globe_with_meridians: Easy Setup: The integration provides a dedicated web interface to easily get your webhook URL.

:iphone: Supported Devices

Works on most devices running Zepp OS 3.0 or higher.

:rocket: How to Install

  1. Home Assistant:

    • Search for “Zepp2Hass” in HACS and install it.
    • Go to Settings → Devices & Services, add the integration, and follow the instructions to get your Webhook URL.

  2. Watch:

    • Open the Zepp App on your phone.
    • Go to the App Store and search for “zepp2hass”.
    • Install it on your watch.
    • In the app settings (on the phone), enter your Webhook URL.

:link: Links

I’d love to hear your feedback! Let me know if you have any questions or feature requests. :point_down:

Happy tracking! :man_running:

3 Likes
2

Nice, I will definitely give it a try. I’m using HA Companion on a Balance to control HA, but retrieving sensor data from the watch is patchy ATM.

Do you have some dashboards built around those sensors to share (would love a cardio graph and maybe a sleep graph too) ?

3

I’m running my Home Assistant through a reverse proxy. So should I still use the webhook as posted by the integration? I can’t seem to get any of the sensors to populate. Perhaps it only works when the watch/phone is connected locally to the network?

4

Nevermind. I just adjusted the custom webhook url in the integration and it works like a charm. Thank you so much for this.