Home ▸ Integrations

Google Health

The Google Health integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] allows you to expose health and fitness data from Google Health (including Fitbit, Pixel Watch, and other devices connected to your Google Account) to Home Assistant.

Prerequisites

You need to configure developer credentials to allow Home Assistant to access your Google Account. These credentials are the same as the ones for Google Photos, Nest, Google Tasks, and Google Mail.

If you have already set up the correct credentials, you can enable the API and then skip the consent screen and credential creation steps.

Generate client ID and client secret

This section explains how to enable the API, configure the consent screen, and generate a client ID and client secret on the Google Developers Console.

First, go to the Google Developers Console to enable the Google Health API.
Select a project and select Continue. Verify that the API is enabled.
Go to the Branding page in the Google Auth Platform Console.
If prompted to configure OAuth, select Get started and follow the setup wizard. When the wizard asks for the user type, select External, and continue once the OAuth consent configuration is created.
Select Branding in the left sidebar. Fill in the required fields:
- App name: Enter a name (like Home Assistant). This is shown during the OAuth login flow.
- User support email: Select your Google Account email.
- Developer contact email: Enter your email address. Leave all other fields empty to avoid triggering Google’s verification process. Select Save.
Select Audience in the left sidebar.
- Under User type, confirm it shows External.
- Under Test users, select + Add users and add your Google Account email address. Select Save.
Under Publishing status, select Publish app to set the status to In production. Make sure the status is not Testing, or your authentication token will expire every 7 days.
Select Credentials in the left sidebar.
Select Create Credentials at the top of the page, then select OAuth client ID.
Set the Application type to Web application and give these credentials a name (like Home Assistant Credentials).
Under Authorized redirect URIs, enter https://my.home-assistant.io/redirect/oauth and select Create. This is not a placeholder and is the URI that must be used.
Copy the Client ID and Client Secret from the pop-up, or select the pencil icon next to your client ID to view them later.

Configuration

To add the Google Health service to your Home Assistant instance, use this My button:

Manual configuration steps

If the above My button doesn’t work, you can also perform the following steps manually:

Browse to your Home Assistant instance.
Go to Settings > Devices & services.
In the bottom right corner, select the Add Integration button.
From the list, select Google Health.
Follow the instructions on screen to complete the setup.

The integration setup will next give you instructions to enter the Application Credentials (OAuth Client ID and Client Secret) and authorize Home Assistant to access your Google Health data.

OAuth and authorization steps

Continue through the steps of selecting the Google Account you want to authorize.
You will be asked to grant access to specific data in your Google Health account. The integration will dynamically adjust based on the permissions you grant:
- Profile (required): Allows Home Assistant to verify your account identity.
- Activity and fitness (optional): Granting this scope creates sensors for steps, distance, active calories, total calories, and floors.
- Health metrics and measurements (optional): Granting this scope creates sensors for weight, resting heart rate, and body fat.
- Sleep data (optional): Granting this scope creates sensors for time asleep, time awake, time in bed, time to fall asleep, and time after wake-up.
- Nutrition and hydration (optional): Granting this scope creates sensors for hydration and calories consumed.
- Paired devices (optional): Granting this scope creates diagnostic sensors for battery level and last sync time for your paired wearables or devices.
You may get a message telling you that the app has not been verified. Acknowledge this to proceed.
You can now see the details of what you are authorizing Home Assistant to access with options at the bottom. Select Continue.
The page will now display Link account to Home Assistant?, noting Your instance URL. If this is not correct, refer to My Home Assistant. If everything looks good, select Link Account.
You may close the window and return to Home Assistant, where you should see a Success! message.

Supported functionality

The Google Health integration provides the following entities:

Sensors

Activity sensors

Available for accounts that grant the Activity and fitness scope.

Active calories: Daily active energy burned.
Distance: Daily distance.
Floors: Daily floors climbed.
Steps: Daily step count.
Total calories: Daily total calories burned.

Body sensors

Available for accounts that grant the Health metrics and measurements scope.

Body fat: Body fat percentage.
Resting heart rate: Daily resting heart rate.
Weight: Body weight.

Sleep sensors

Available for accounts that grant the Sleep data scope.

Time asleep: Duration spent asleep during the sleep period.
Time awake: Duration spent awake during the sleep period.
Time in bed: Total duration spent in bed during the sleep period.
Time to fall asleep: Duration taken to fall asleep.
Time after wake-up: Duration spent in bed after waking up.

Nutrition sensors

Available for accounts that grant the Nutrition and hydration scope.

Calories consumed: Daily energy consumed.
Hydration: Daily volume of liquids consumed.

Paired device sensors

Available for accounts that grant the Paired devices scope.

Battery level (Diagnostic): Battery percentage of paired fitness trackers or smartwatches.
Last sync time (Diagnostic): Timestamp when the paired fitness tracker or smartwatch last synced data to Google Health.

Google Health automation examples

The real power of this integration is automating your home environment or notifications based on your health metrics. Here are a few ideas to get you started.

Tip

You don’t need to edit YAML to use these examples. Copy a YAML snippet from this page, open the automation editor in Home Assistant, and press Ctrl+V (or Cmd+V on Mac). Home Assistant automatically converts the pasted YAML into the visual editor format, whether it’s a full automation, a single trigger, a condition, or an action.

Automation: Step goal reminder

Send a notification in the evening if you have not met your daily step goal.

Trigger: Time: 20:00 (8:00 PM)
Condition: Numeric state: steps sensor is below your goal (for example, 10,000 steps)
Action: Send a notification to your mobile phone

YAML example for step goal reminder

Automation

alias: "Reminder to meet daily step goal"
triggers:
  - trigger: time
    at: "20:00:00"
conditions:
  - condition: numeric_state
    entity_id: sensor.google_health_steps
    below: 10000
actions:
  - action: notify.mobile_app_your_phone
    data:
      message: >
        You have only completed
        {{ states('sensor.google_health_steps') }} steps today.
        Time for a short walk!

Automation: Resting heart rate alert

Notify you if your daily resting heart rate goes above a certain threshold (for example, 80 bpm), which could indicate fatigue or stress.

Trigger: State: resting heart rate sensor state changes
Condition: Numeric state: resting heart rate is above 80 bpm
Action: Send a notification

YAML example for resting heart rate alert

Automation

alias: "Alert on high resting heart rate"
triggers:
  - trigger: state
    entity_id: sensor.google_health_resting_heart_rate
conditions:
  - condition: numeric_state
    entity_id: sensor.google_health_resting_heart_rate
    above: 80
actions:
  - action: notify.mobile_app_your_phone
    data:
      message: >
        Your resting heart rate is higher than usual at
        {{ states('sensor.google_health_resting_heart_rate') }}
        bpm. Make sure to rest!

Data updates

The integration updates sensors on different intervals based on the data type:

Activity sensors (Steps, Distance, Active calories, Total calories, Floors) are updated every 15 minutes.
Sleep sensors (Time asleep, Time awake, Time in bed, Time to fall asleep, Time after wake-up) are updated every 15 minutes.
Nutrition sensors (Hydration, Calories consumed) are updated every 15 minutes.
Body sensors (Weight, Resting heart rate, Body fat) are updated every hour.
Paired device sensors (Battery level, Last sync time) are updated every hour.

Known limitations

Polling frequency: Data is fetched from the Google Health API periodically (every 15 minutes for activity, sleep, and nutrition data; every hour for body measurements and paired devices). Real-time event streaming is not supported.
Device sync latency: Data displayed in Home Assistant depends on when your fitness tracker, smartwatch, or mobile app syncs its data to Google Health cloud servers.
Scope-dependent entities: Entities are created dynamically based on the permission scopes granted during the initial OAuth authorization. If a specific scope is unselected, entities for that category will not be created.
Daily rollups: Activity and sleep sensors reflect cumulative daily totals or aggregate summary metrics for the current calendar day.

Troubleshooting

Resetting a broken or incorrect configuration

If the Google Health integration was initially configured incorrectly, you can delete the credentials in the Application Credentials user interface and start the setup again.

Connection failed after authorization

If authorization appears to succeed but Home Assistant returns a connection error, verify that you granted the required Profile permission. Home Assistant requires the profile scope to verify your account identity and setup the integration.

Removing the integration

This integration follows standard integration removal.

To remove an integration instance from Home Assistant

Go to Settings > Devices & services and select the integration card.
From the list of devices, select the integration instance you want to remove.
Next to the entry, select the three dots menu. Then, select Delete.

Help us improve our documentation

Suggest an edit to this page, or provide/view feedback for this page.