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.
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
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.
-
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.
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
- “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
- 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.