Skip to content
Home Assistant TestFlight
Lighting

Alexa Media Player

alandtse/alexa_media_player · vv5.18.0

HACSCloud polling

This is a custom component to allow control of Amazon Alexa devices in Home Assistant using the unofficial Alexa API.

In Apple Home through HomeKit Bridge

What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.

EntityShows up asNote
lightLight
switchSwitch or outlet
media_playerTV, receiver or media switchesNeeds its own HomeKit Bridge in accessory mode
alarm_control_panelSecurity system
binary_sensorSensor (motion, contact, leak, smoke…)
sensorSensor (temperature, humidity, air quality…)
selectMode picker (as switches)

What people report

Echo devices are controlled via Amazon's cloud, so no local playback of custom MP3s and login/2FA setup is a frequent pain. New Echo models are added quickly.

  • Works7
  • Partly works2
  • Won’t be supported1
DeviceIn Home AssistantIn Apple HomeWhat they saidSource
Amazon Air Quality MonitorWorks CloudEntities including TVOC appear via Alexa Media Player integration
Saved copy
For those interested in TVOC, the Amazon Air Quality Monitor uses a SEN44 that I think is the same as the SEN54, the difference being that Sensirion won't issue a data sheet for the SEN44 as it is not a retail product. Looks the same. The Amazon entities, including TVOC, are revealed in HA using the "Alexa Media Player" integration listed under HACS. They don't show as devices as they piggy-back on the Echo devices, so prepare to be mystified. Sensiron publish their methodology for TVOC data analysis, referencing current values to a moving average of all data over the previous 24 hours on a …

Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23.

Reddit comment · 2023-03
Amazon Echo DotWorks CloudTTS and sound library playback in HA; notifications quick without lag
Saved copy
I have Amazon Echo Dots in each room and they are accessible to HA using the Alexa Media Player integration which I think came from HACS. It can use Text to speech (TTS) to make the Echo Dots say anything I want. It can also make the Echo Dots play any sound in the Alexa Audio Library which includes various dog barking recordings. I believe there is a way to have them play custom mp3 files but I haven’t tried that out. The Amazon Echo Dots require internet connectivity to work so be aware of that. Just my 2 cents for what you are looking for.

Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23.

Reddit comment · 2023-12
Amazon Indoor Air Quality MonitorWorks CloudNow a device grouping air quality and temperature sensors
Saved copy
Introduce a Home Assistant device to represent the Amazon Indoor Air Quality Monitor (AIAQM) device - Group all AIAQM-related entities (air quality sensors and temperature) under this device - Replace previously unattached AIAQM entities with a properly grouped device representation - Preserve existing entity IDs and behavior for non-AIAQM devices - Filter AIAQM sub-sensors using asset-based friendly names to avoid exposing unsupported capabilities (e.g. PM10: "@type : text") - No new services, controls, or configuration options added Amazon’s _Indoor Air Quality Monitor_ reports multiple …

Excerpt saved from GitHub on 2026-10-23.

PR #3314 · 2026-01
Denon Home 150Works CloudSupport added
Saved copy
Inspired by #3378 I added two of my Denon devices. One limitation: I dont have a Denon Home 350, so don't know what the identifier of that one is. ## Summary by CodeRabbit * New Features * Added support for Denon Home 150 and Denon Home 250 speakers, discoverable, status shown, and controllable from the app. * Other * Updated device naming for a Fire TV entry to "Fire TV Stick 4K Max (Gen1)" for clearer identification.

Excerpt saved from GitHub on 2026-10-23.

PR #3381 · 2026-02
Denon Home 250Works CloudSupport added
Saved copy
Inspired by #3378 I added two of my Denon devices. One limitation: I dont have a Denon Home 350, so don't know what the identifier of that one is. ## Summary by CodeRabbit * New Features * Added support for Denon Home 150 and Denon Home 250 speakers, discoverable, status shown, and controllable from the app. * Other * Updated device naming for a Fire TV entry to "Fire TV Stick 4K Max (Gen1)" for clearer identification.

Excerpt saved from GitHub on 2026-10-23.

PR #3381 · 2026-02
Echo Show 11 (Gen1)Works CloudAdded to device list
Saved copy
Summary by CodeRabbit * Bug Fixes * Added support for Echo Show 11 (Gen1) device in Alexa Media component.

Excerpt saved from GitHub on 2026-10-23.

PR #3378 · 2026-02
Echo Show 8 (Gen4)Works CloudDevice type added
Saved copy
Adds the device type for the 2025 Echo Show 8 (4th gen, model MD6NE4, the Alexa+ model with spatial audio) to `MODEL_IDS`, so it shows as "Echo Show 8 (Gen4)" instead of the raw family and type (`KNIGHT A345JHMQDGG1M5`). Tested on my own device: it reports device type `A345JHMQDGG1M5`, and the sticker model number is MD6NE4. ## Summary by CodeRabbit - New Features - Added support for identifying the Echo Show 8 (4th Generation) device.

Excerpt saved from GitHub on 2026-10-23.

PR #3635 · 2026-10
Alexa Media Player (Echo devices)Partly worksMusic can be played to Echo; multiroom sync with TV audio has delay
Saved copy
How to? Create a multiroom audio system using echo devices that takes input from my home theater system. I am in the process of moving everything over to home assistant and and am currently working on my home theater setup. I have Sonos or Bose wireless system on my short list of things to buy, but I already have so many devices and wanted to see if I could get something to work in the meantime. I currently have HA running on a NUC, an Nvidia Shield, an LGC1 oled tv, a PS5, and a Samsung Q950A soundbar system in my livingroom. Q950A is pretty decent and connected to the tv via eARC, so any …

Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23.

Reddit thread · 2023-12
Echo Dot custom MP3 playbackPartly works CloudDirect music streaming unsupported; needs public HTTPS audio
Saved copy
… there! I got past the "500 Internal Service" error and I have an automation set up to play a sound effect when a specific trigger is enabled. Now - my Echo Dot is complaining that "Direct Music Streaming Isn't Supported", something that is set by Amazon, and not my AMP or HA. I'm attempting to play a sound effect, about 7 sec long. My "type" is set to music. If I change the type to "sound", I do not get an error, but the sound never plays, either. In my config, I've tried just the filename.mp3, then doing local/filename.mp3, and finally, the entire path, …

Excerpt saved from GitHub on 2026-10-23.

Discussion #2774 · 2024-12
Echo devices with Home Assistant Radio BrowserWon’t be supported CloudEcho connects to Amazon cloud, so HA radio streams can't play
Saved copy
No, the Home Assistant Radio browser streams from the cloud through Home Assistant to locally connected media players and Echo media players are connected to Amazon cloud, not Home Assistant. Echo media players can only stream from cloud services via skills in Amazon like Spotify, Tune-In, etc. Alexa Media Player is emulating an Alexa app so if the Alexa app can't do it, AMP can't either. Think of it as the AMP Echo media players are remote controlling the Echo through Amazon cloud like the app does.

Excerpt saved from GitHub on 2026-10-23.

Discussion #3477 · 2026-05

Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.

How it connects

Cloud polling

Goes through the maker’s cloud, asking it for updates every so often. Needs the internet and an account.

Details

Installs (analytics)30,011 (4.24%)
GitHub stars1,991
Latest versionv5.18.0 (2026-10-22)
Set up in the UIYes
Maintainers@alandtse, @keatontaylor
LicenseApache-2.0

Notable forks

Forks with stars, or with code pushed at least 90 days after the original’s last push. Useful when the original goes quiet.

ForkStarsLast pushDescription
keatontaylor/alexa_media_player★ 172023-11-28This is a custom component to allow control of Amazon Alexa devices in Home Assistant using the unofficial Alexa API.
nao-pon/alexa_media_player★ 32026-02-15This is a custom component to allow control of Amazon Alexa devices in Home Assistant using the unofficial Alexa API.

In ReReHome

Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.

Bridges get their own settings page listing the accessories behind them.