Voice and AI

How to Add Alexa to Home Assistant

Connect Alexa to Home Assistant with Nabu Casa or a free manual skill, expose entities for voice control, and bring your Echo devices into Home Assistant too.

On this page
  1. Option 1: Home Assistant Cloud (Nabu Casa)
  2. Option 2: Manual Smart Home skill (free, advanced)
  3. Option 3: Emulated Hue (local, limited)
  4. Bringing Echo devices into Home Assistant
  5. Privacy and safety
  6. Common misconceptions

Alexa and Home Assistant can connect in two directions, and each needs its own setup:

  • Alexa controls Home Assistant. You say a command to an Echo, and Home Assistant runs it.
  • Home Assistant uses your Echo devices. The Alexa Devices integration brings Echo devices into Home Assistant, so you can use them for announcements and automations.

Option 1: Home Assistant Cloud (Nabu Casa)

This is the simplest way to let Alexa control Home Assistant. The Home Assistant Cloud subscription costs about $6.50 a month or $65 a year in the US at the time of writing, and the price varies by region. A free trial is available.

  1. Go to Settings > Home Assistant Cloud and enable Alexa.
  2. Go to Settings > Voice assistants > Expose and turn on the Alexa toggle for each entity you want Alexa to control.
  3. In the Alexa app, open Skills, find the Home Assistant skill, enable it and link your account.
  4. Say “Alexa, discover devices.” Alexa will find the exposed entities.

Scripts and scenes appear in Alexa as scenes, so you can say “Alexa, turn on bedtime” to run one. Exposed sensors, such as contact, motion and temperature sensors, can trigger Alexa routines.

If you need finer control over what is exposed, the YAML cloud: alexa: filter: option overrides the settings in the UI.

Option 2: Manual Smart Home skill (free, advanced)

The manual method uses your own Amazon developer account and an AWS Lambda function. It costs nothing for home use within the Lambda free tier. It takes about one to two hours, and it needs more setup than Nabu Casa.

You will need:

  • An Amazon developer account and an AWS account.
  • External access to Home Assistant over HTTPS on port 443.
  • Account linking with Login with Amazon.
  • A Lambda region that matches your locale. For example, us-east-1 suits North America, eu-west-1 suits the EU, UK and India, and us-west-2 suits Japan and Australia.

Add this to configuration.yaml:

alexa:
  smart_home:

This method exposes Home Assistant to the internet. Use strong passwords and multi-factor authentication before you open it up.

Option 3: Emulated Hue (local, limited)

Emulated Hue is free and local. It makes Home Assistant look like a Philips Hue bridge to Alexa, so Alexa can control the devices you expose. Alexa sees every exposed device as a light, so control is limited to basic on, off and dimming. Newer Echo models have needed port 80 for this, so check the current documentation before you set it up.

Bringing Echo devices into Home Assistant

To use Echo devices as Home Assistant entities, add the official Alexa Devices integration:

  1. Go to Settings > Devices & services > Add integration and choose Alexa Devices.
  2. Sign in with your Amazon email address and password, then enter the one-time code from your authenticator app.
  3. Assign your Echo devices to rooms and finish setup.

To make an Echo speak a Home Assistant message, use the Alexa Media Player from HACS, or the notify and announce actions in the Alexa Devices integration. Do not use tts.speak for Echo speakers. The text-to-speech guide explains why.

Privacy and safety

  • Linking Alexa does not make commands local. Requests go through Amazon’s cloud. Emulated Hue is the local option, but it is limited.
  • Set a voice PIN in the Alexa app before you expose locks. Check Amazon’s current documentation for how unlock requests are handled, because that behavior can change.
  • The manual method exposes Home Assistant to the internet. Use strong passwords and multi-factor authentication.

Common misconceptions

  • Linking Alexa does not make commands local. They go through Amazon’s cloud.
  • An Echo cannot be used as an Assist satellite. For a voice satellite you control, see Home Assistant voice control.
  • New entities usually need a discovery pass. Unless Nabu Casa syncs them for you, ask Alexa to discover devices again. If one is still missing, check that it is exposed.
  • The Alexa Media Player does not let Alexa control Home Assistant. It works in the other direction, so Home Assistant can send announcements to Echo devices.

The complete guide to voice and ai

Home Assistant Voice Control: Wake Words and Local Voice Assistants
Read the guide

Keep exploring

Guides from other topics

All topics →