Add Alexa Devices to Home Assistant: A Step-by-Step Guide for 2026

By Colin Foster

To add Alexa devices to Home Assistant, you install an integration that connects your Amazon account, then select which Echo speakers, Fire TV units, and other Alexa-enabled hardware you want to expose. Once it is set up, you can read device states, trigger announcements, control media playback, and build automations that mix Alexa hardware with the rest of your smart home. This guide walks through the process, the prerequisites, and the mistakes that trip up most people.

What You Need Before You Start

Before you touch any configuration, confirm that your setup meets the basic requirements. Most connection problems come from skipping this step.

Shopping for one? See our guide: 9 Best Alexa Compatible Devices for Smart Home Setups (2026).

• A working Home Assistant installation (Home Assistant OS, Supervised, or Container) that you can reach from a browser.
• An Amazon account that owns the Alexa devices you want to add. If devices are on a different account, you will need to add that account instead.
• Two-step verification turned off on that Amazon account, or access to the one-time codes it sends. Many integrations struggle with two-step verification enabled.
• Access to your Home Assistant configuration folder or the HACS store, depending on which installation method you choose.
• Your Alexa devices online and visible in the Alexa app. If a device does not appear there, it will not appear in Home Assistant.

Choosing the Right Integration

Home Assistant does not ship with a single built-in Alexa connector that covers every device type. Most users rely on the community-maintained Alexa Media Player custom integration, which is installed through the Home Assistant Community Store (HACS). It exposes Echo devices as media players and provides notify and announcement services. It can also surface Alexa device sensors such as volume and do-not-disturb state.

The official Alexa Smart Home skill works in the opposite direction. It lets Alexa control devices that Home Assistant exposes, and it is covered in more detail in other guides on this site. If your goal is to make Alexa speak, play media, or report device status into Home Assistant, the Alexa Media Player route is the one you want. Our overview of Comparison of Alexa Devices (2026): Which Is Better for Your Home? can help you decide which Echo models are worth connecting first.

Step-by-Step: Installing Alexa Media Player

Step 1: Install HACS

If HACS is not already installed, follow the official HACS documentation for your installation type. HACS adds a community tab to the Home Assistant sidebar and gives you access to third-party integrations. Restart Home Assistant after the installation finishes.

Step 2: Install the Alexa Media Player Integration

1. Open HACS from the sidebar and select Integrations.
2. Search for “Alexa Media Player” and open the entry.
3. Choose Download and select the latest release.
4. Restart Home Assistant when prompted. The integration will not load until the restart is complete.

Step 3: Add the Integration and Log In

1. Go to Settings, then Devices and Services, then Add Integration.
2. Search for “Alexa Media Player” and select it.
3. Enter the email and password for your Amazon account. Select your Amazon domain (for example, amazon.com for US accounts).
4. Complete any verification prompt. If Amazon asks for a one-time code, enter it in the window that appears.

If the login fails, check that the password has no stray characters from copy-pasting and that your Amazon region matches the domain you selected. Our walkthrough on How to Add a Matter Device to Your Smart Home covers a different protocol, but the same principle applies: confirm the device or account is reachable before blaming the integration.

Step 4: Select Your Devices

After login, the integration lists the Alexa devices associated with your account. Choose which ones to include. You can add everything, but many users prefer to start with the main Echo speakers so they can verify the connection before adding Fire TV units, Echo Shows, or other hardware. Each selected device becomes a media player entity in Home Assistant, typically named after the device name in the Alexa app.

Step 5: Confirm Entities Appear

Go to Settings, then Devices and Services, then Entities, and filter by “alexa”. You should see media player entities, notify entities, and sensors for each device. If a device is missing, return to the integration options and check that it is selected. Devices that are offline in the Alexa app will also be missing or unavailable.

Using Your Alexa Devices in Automations

Once the entities exist, you can use them like any other Home Assistant device. Three common uses are worth setting up right away.

• Announcements: Call the notify service for a specific Echo to speak a message, such as a doorbell alert or a reminder that the laundry is done.
• Media control: Use the media player entity to start playlists, adjust volume, or pause playback from a dashboard or automation.
• Presence and routines: Trigger a spoken greeting when a person arrives, or lower volume automatically overnight using a time-based condition.

When writing an automation, reference the entity ID exactly as it appears in the entity list. Renaming a device in the Alexa app can change the entity name, which will break automations that rely on the old ID. Rename entities inside Home Assistant if you want stable names.

Comparing Common Setup Paths

The table shows that the two directions of control are separate features. Adding Alexa devices to Home Assistant does not automatically make Alexa control your Home Assistant entities. You will need the second method for that.

Recommended gear

A few supporting items make a Home Assistant and Alexa setup more reliable, especially when your network is busy.

• Ethernet adapter or wired backhaul for your Home Assistant host: A wired connection keeps the integration responsive when Wi-Fi is congested. View on Amazon
• Small UPS for the Home Assistant host: Brief power dips can corrupt storage and force you to re-authenticate integrations. View on Amazon
• Dedicated mini PC for Home Assistant OS: Running Home Assistant on dedicated hardware is more stable than a crowded Raspberry Pi SD card setup. View on Amazon

Common Mistakes

• Two-step verification enabled: This is the most frequent cause of login failures. Use the integration’s guidance for one-time codes, or temporarily adjust your account settings.
• Wrong Amazon domain: A US account set to a UK domain will fail silently or show no devices.
• Skipping the restart: The integration may appear installed but will not load until Home Assistant restarts.
• Renaming devices in the Alexa app: Entity IDs can change and break automations. Rename in Home Assistant instead.
• Adding too many devices at once: Start with a few Echo speakers. Troubleshooting is much easier with a small set.
• Expecting full two-way control: The media player integration controls Echo speakers, but it does not replace the Alexa Smart Home skill for voice control of your lights and locks.

Tips for a Stable Connection

• Keep Home Assistant and the integration updated, since changes on Amazon’s side sometimes require a new release.
• Check the integration logs under Settings, then System, then Logs if a device goes unavailable.
• Use a static IP or DHCP reservation for the Home Assistant host so that remote access stays consistent.
• If you also use Siri, the approach to cross-platform control is covered in Use Siri to Control Alexa Devices: A Step-by-Step Guide.
• Before retiring an old Echo, remove it from the integration first so Home Assistant does not keep a dead entity. What to Do With Old Alexa Devices: Recycle, Reset, or Repurpose explains the cleanup steps.

FAQ

Do I need a paid Home Assistant subscription to add Alexa devices?

No. The Alexa Media Player integration is free and runs on your own Home Assistant installation. Home Assistant Cloud is a separate optional service for remote access and voice assistant features.

Will my Alexa devices still work normally after adding them to Home Assistant?

Yes. The integration adds a connection on top of your existing setup. Your Echo devices continue to respond to voice commands and Alexa routines as before.

Why does my Echo show as unavailable in Home Assistant?

The device may be offline, the Amazon session may have expired, or the integration may need a reload. Check the device in the Alexa app first, then reload the integration from its entry in Devices and Services.

Can I use Alexa Media Player with multiple Amazon accounts?

Yes. You can add the integration more than once, each time with a different Amazon login. Each account creates its own set of entities.

Does this let Alexa turn on my lights that are connected to Home Assistant?

Not through the Alexa Media Player integration alone. Voice control from Alexa into Home Assistant requires a separate setup, typically the Alexa Smart Home skill or Home Assistant Cloud.

Will the integration work if Amazon changes its API?

Community integrations can break when Amazon changes its services. Updating the integration usually restores function. Watch the project’s release notes after major Amazon changes.

Can I send text-to-speech from Home Assistant to any Echo in the house?

Yes, once the Echo is added as a media player and the notify service is available. Choose the target device in your automation or script.

Is it safe to store my Amazon password in Home Assistant?

The integration stores session credentials in your Home Assistant configuration. Keep your Home Assistant instance secured with strong passwords, restricted remote access, and regular backups. If you have concerns about account security, consult a qualified IT professional.

Conclusion

Adding Alexa devices to Home Assistant comes down to installing the Alexa Media Player integration through HACS, logging in with your Amazon account, and selecting the Echo devices you want. Once the entities appear, you can use them for announcements, media control, and automations. Remember that this path controls Echo speakers from Home Assistant; voice control of Home Assistant from Alexa is a separate task. Start small, keep your logins stable, and expand once the connection is reliable.

About Colin Foster

Colin Foster is part of our editorial team and reviews and edits our smart home guides, checking product details against manufacturer specifications and owner feedback.