2025.7.3
Home ▸ Integrations ▸

Alexa Devices

The Alexa Devices integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] lets you control Alexa-enabled devices connected to your Amazon account.

The integration provides information on connected devices and enables control of the main features.

Supported devices

There is support for the following device families within Home Assistant:

  • Amazon Echo Auto

  • Amazon Echo Dot

  • Amazon Echo Flex

  • Amazon Echo Plus

  • Amazon Echo Show

  • Amazon Fire TV Stick

  • Amazon Fire Tablet

  • Third-party devices with built-in Alexa capabilities.

Warning

This integration requires multifactor authentication using an authentication app (such as Microsoft Authenticator, for example). To enable MFA, in your Amazon account settings select Login & Security > 2-step verification > Backup methods > Add new app. See Amazon’s documentation for more information.

Configuration

To add the Alexa Devices hub 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 Alexa Devices.

  • Follow the instructions on screen to complete the setup.

country

The country of your Amazon account.

username

The email address of your Amazon account.

password

The password of your Amazon account.

otp

One-time password via Authenticator App.

Note

When trying to set up the integration, the form may show the message “Cannot connect”. This means that the specified country may need a special setting. Open a issue with all details to investigate

Examples

Automation: Announce welcome when you arrive home 

automation:
- alias: "Alexa Announce"
  id: "alexa_announce"
  triggers:
    - platform: state
      entity_id: person.simone
      to: "home"
  actions:
    - action: notify.send_message
      data:
        message: Welcome home Simone
      target:
        entity_id: notify.echo_dot_livingroom_announce

Data updates

This integration pollsData polling is the process of querying a device or service at regular intervals to check for updates or retrieve data. By defining a custom polling interval, you can control how frequently your system checks for new data, which can help optimize performance and reduce unnecessary network traffic. [Learn more] data from the device every 30 seconds by default.

Supported functionality

The Alexa Devices integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] provides the following entities:

  • Binary sensor - main and Bluetooth connectivity
  • Notify - Speak and Announce notifications
  • Sensor - temperature and illuminance sensors
  • Switch - Do not disturb

Troubleshooting

Can’t set up the integration

Symptom: “Wrong Country”

When trying to set up the integration, the form shows the message “Wrong Country”.

Description

This means that the settings in your Amazon account are not aligned to the country you specified. To fix it, please go to https://www.amazon.XX/hz/mycd/preferences/myx#/home/settings/payment (replace XX with your country domain. For example co.uk):

  • “Kindle payment”: check your default address is in your country
  • “Country/Region”: check your country

Symptom: “Not found”

When trying to set up the integration, the form shows the message “Not found”.

Description

This appears to indicate that your Alexa devices aren’t owned by you, but are connected through Amazon Family. This setup isn’t supported by the Alexa Mobile app, so it’s not supported by this integration. Move the devices to your primary account.

Removing the integration

This integration follows standard integration removal. No extra steps are required.

To remove an integration instance from Home Assistant

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