Getting Started¶

Before you start¶

You need:

• Home Assistant 2026.10.0 or later.
• Google speakers or displays, such as a Nest Mini, Nest Audio or Nest Hub. The integration doesn't add the other devices in your Google Home app, such as lights or thermostats. See Other Google Home devices.
• A Google account that is a member of your home in the Google Home app. Open the Google Home app with that account and check that your devices are listed.
• Home Assistant on the same local network as your devices, so the integration finds them automatically. If you run Home Assistant in Docker, set the container's network mode to host, as the official installation guide does. If your devices are on another network, or the container can't use host mode, add them as known hosts instead.

Install the integration¶

Add the integration¶

1. Add the Google Home integration, or go to Settings > Devices & services > Add integration and search for Google Home.
2. Choose how to sign in, and follow its steps below:
   • Browser sign-in (recommended): you sign in to Google in a desktop browser and copy a cookie from it.
   • Master token: if you already have one, for example from another tool.

Home Assistant then adds a device for each Google Cast device in your home, with the entities for it. Devices that have no alarms or timers, such as an NVIDIA Shield, get only a device sensor.

To change the account or sign in again, delete the integration and add it again.

Browser sign-in¶

You need a computer with a desktop browser, such as Chrome, Edge or Firefox. Phones don't show the cookies you need.

1. In a private browser window, open accounts.google.com/EmbeddedSetup and sign in with the Google account you want to use.
2. Accept the prompt. The page may then keep loading forever; that is expected.
3. Press F12, or Cmd+Option+I on a Mac, to open the browser's developer tools. Then open the cookies for https://accounts.google.com:
   • Chrome or Edge: Application > Cookies. If you can't see the Application tab, select >> to show more tabs.
   • Firefox: Storage > Cookies.
4. Find the oauth_token row, double-click its value to select all of it, and copy it. It starts with oauth2_4/.
5. In Home Assistant, select Browser sign-in (recommended), paste the cookie into oauth_token cookie, and select Submit.

The cookie expires within minutes and works only once, so paste it straight away. If setup says "Google didn't accept the cookie", close the private window and repeat from step 1.

Home Assistant exchanges the cookie for a master token, names the entry after the account Google reports, and keeps only the master token.

Master token¶

Select Master token, paste the token into Google account master token, and select Submit. A master token starts with aas_et/ and is 223 characters long. The integration looks up which Google account the token belongs to and names the entry after it.

Change the update interval¶

The integration checks your devices for changes every 180 seconds.

To change the interval, go to Settings > Devices & services > Google Home and select Configure. If your devices time out, increase the interval until they stay stable. Shorter intervals update alarms and timers sooner but send more requests to your devices.

To update immediately, use the Refresh devices action.

Add devices on another network¶

The integration finds your devices on your network with multicast DNS (mDNS). mDNS usually doesn't reach other networks, such as a separate VLAN for smart home devices, or a Home Assistant container that doesn't use host network mode. Those devices then have only a device sensor. If Home Assistant can reach a device on TCP port 8443, add its IP address instead:

1. Go to Settings > Devices & services > Google Home and select Configure.
2. Under Known hosts, add the IP address of each device that the integration can't find.
3. Select Submit. The integration reloads, asks each address which device it is, and uses the address for that device.

Give these devices fixed IP addresses in your router, so the addresses don't change. For a speaker pair, add the addresses of both speakers. Only the speaker that leads the pair reports it, so the integration uses that one and ignores the other.

Remove a device¶

When you remove a device from the Google Home app or factory reset it, the integration notices only when it next loads. Reload it: Settings > Devices & services > Google Home > ⋮ > Reload. Then open the device's page in Home Assistant, open the ⋮ menu and select Delete.

Home Assistant offers Delete for every device of the integration, but you can't delete one that Google still lists in your home, even if it shows as unavailable: it would come back the next time the integration loads. Home Assistant then shows "Failed to remove device entry, rejected by integration".

Remove the integration¶

1. Go to Settings > Devices & services > Google Home, open the ⋮ menu and select Delete. Home Assistant deletes the master token it stored.
2. If you installed with HACS, open HACS, select Google Home, open the ⋮ menu and select Remove. If you installed manually, delete the custom_components/google_home folder.
3. Restart Home Assistant.

Deleting the integration doesn't stop the master token from working, and the integration can't revoke it. If the token might have been copied, for example from a Home Assistant backup:

• If you created a separate Google account for the integration, delete that account.
• Otherwise, change the Google account's password. Google then signs you out on most devices and apps, but it lists exceptions, so this isn't guaranteed to stop the master token.