The Garmin Connect integration with Home Assistant is now a custom component

Disclosure: This post contains affiliate links. If you click through and make a purchase, I will earn a commission, at no additional cost to you. Read my full disclosure here.

A person's wrist wearing a black Garmin sports watch. The watch face displays the time as 12:10, along with the date 'Fri 26' and a heart rate reading of '64'. There's also a battery indicator and Bluetooth symbol shown at the top of the watch face. The background is blurred, focusing attention on the watch.

Home Assistant Core recently got rid of the Garmin Connect integration due to its reliance on web scraping. Unfortunately, Garmin removed the possibility for projects like Home Assistant to access the API, and is now offering it exclusively to businesses. Luckily, the code used for the Garmin integration previously included with Home Assistant Core was still somewhat useable, and it is now offered as a custom component.

The current Garmin integration with Home Assistant isn't perfect, and it might break at any time, but it is the only option for those that want to import their fitness and health data from their sports watch. This short guide will show you how to install and set up this integration.


Installing the Garmin Connect custom component

There is only one way I ever recommend installing custom components: HACS, or the Home Assistant Community Store. Once you have HACS set up, you can simply search for, and install, the Garmin Connect integration. After restarting your server, you are ready to integrate Garmin Connect. If you can't find the repository in HACS, you can add it manually using the following URL:

If done correctly and restarted your server, the Garmin Connect custom component will appear in the list of all components you have installed using HACS.

The Garmin Connect custom component in the Home Assistant Community Store.

Setting up the Garmin Connect integration

As I already mentioned, the Garmin Connect integration with Home Assistant isn't perfect. It is when setting up this integration that this might become obvious. For example, you will need to wait a couple of minutes after your Home Assistant has booted until it will accept your username and password.

Garmin Integration Search

Once a couple of minutes have passed, head over to the settings in the web dashboard and add a new integration. From there, search for Garmin and click on the result.

Next, you will have to enter your email addressed used with the Garmin Connect account and the password. If you receive any errors after clicking on submit, I suggest you wait a bit longer and try it again.

You will now be able to see data from your Garmin Connect account in Home Assistant. Be warned, that the data will be out of sync because your sports watch only periodically syncs with your phone, and the integration can only fetch data every ~5 minutes.

Two fields allowing a Home Assistant user to enter their Garmin Connect username (email) and password.
A portrait photo oif Liam Alexander Colman, the author, creator, and owner of Home Assistant Guide wearing a suit.

About Liam Alexander Colman

is an experienced Home Assistant user who has been utilizing the platform for a variety of projects over an extended period. His journey began with a Raspberry Pi, which quickly grew to three Raspberry Pis and eventually a full-fledged server. Liam's current operating system of choice is Unraid, with Home Assistant comfortably running in a Docker container.
With a deep understanding of the intricacies of Home Assistant, Liam has an impressive setup, consisting of various Zigbee devices, and seamless integrations with existing products such as his Android TV box. For those interested in learning more about Liam's experience with Home Assistant, he shares his insights on how he first started using the platform and his subsequent journey.

Leave a comment

Share to...