home-assistant.io/source/_integrations/alexa_devices.markdown

title, description, ha_category, ha_release, ha_domain, ha_config_flow, ha_codeowners, ha_iot_class, ha_platforms, ha_integration_type, ha_quality_scale

title	description	ha_category	ha_release	ha_domain	ha_config_flow	ha_codeowners	ha_iot_class	ha_platforms	ha_integration_type	ha_quality_scale
Alexa Devices	Instructions on how to integrate Alexa Devices into Home Assistant.	Binary Sensor Notify Sensor Switch	2025.6	alexa_devices	true	@chemelli74	Cloud Polling	binary_sensor diagnostics notify sensor switch	hub	silver

The Alexa Devices {% term integration %} 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.

{% endwarning %}

{% include integrations/config_flow.md %}

{% configuration_basic %} country: description: The country of your Amazon account. username: description: The email address of your Amazon account. password: description: The password of your Amazon account. otp: description: One-time password via Authenticator App. {% endconfiguration_basic %}

{% 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 {% endnote %}

Actions

Available Actions

Available actions: notify.send_message, alexa_devices.send_sound, alexa_devices.send_text_command

Action notify.send_message

Devices with appropriate functionality will have speak and announce notify entities created. These can be used as the target for the notify.send_message action.

{% tip %} When sending notifications to multiple devices, you may experience delays due to rate limiting by Amazon. You can avoid this by sending notifications to speaker groups created in Alexa. {% endtip %}

Action alexa_devices.send_text_command

This action essentially allows you to control Alexa using text commands rather than speech. You should be able to request anything you would via speech using this action.

Data attribute	Optional	Description
device_id	no	Device on which you want to run action
text_command	no	Command to send

Action alexa_devices.send_sound

This action allows you to play one of the built-in Alexa sounds. The full list of sounds and their variants is available in Amazon's documentation

Data attribute	Optional	Description
device_id	no	Device on which you want to play sound
sound_variant	no	The variant you want to play (generally 1)
sound	no	The name of the sound to play

Examples

Send announcement 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

Ask the time

action: alexa_devices.send_text_command
data:
  device_id: 037d79c1af96c67ba57ebcae560fb18e
  text_command: whats the time

Play BBC Radio 6

action: alexa_devices.send_text_command
data:
  device_id: 037d79c1af96c67ba57ebcae560fb18e
  text_command: play BBC Radio 6

Play a doorbell sound

action: alexa_devices.send_sound
data:
  sound_variant: 1
  sound: amzn_sfx_doorbell_chime
  device_id: 037d79c1af96c67ba57ebcae560fb18e

Play alternative doorbell sound

action: alexa_devices.send_sound
data:
  sound_variant: 2
  sound: amzn_sfx_doorbell_chime
  device_id: 037d79c1af96c67ba57ebcae560fb18e

Data updates

This integration {% term polling polls %} data from the device every 30 seconds by default.

Supported functionality

The Alexa Devices {% term integration %} provides the following entities:

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

Known limitations

This integration requires multifactor authentication using an authentication app (such as Microsoft Authenticator). 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.

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.

{% include integrations/remove_device_service.md %}