Music Assistant
music_assistant
The Music Assistant (MA) integration allows you to connect Home Assistant to a Music Assistant Server. Once configured, all MA Players show up as Home Assistant media player entities. Media players will allow you to control media playback and see the currently playing item.
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.
| Entity | Shows up as | Note |
|---|---|---|
switch | Switch or outlet | |
media_player | TV | Needs its own HomeKit Bridge in accessory mode |
button | Button (as a switch) | |
select | Mode picker (as switches) |
What people report
Local-push integration to Music Assistant server. Reports are about player behaviour and connection, with sound mode and player options support recently added.
- Works5
- Not working2
- Won’t be supported1
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| Google Home Mini | Works | Cheap background music via Music Assistant; stereo pairingSaved copyIf you just want decent sounding background music without the high cost, try using Google Home Minis with Music Assistant integration. For better sound, you can step up to the larger speakers in their line up. The minis can be paired in stereo and I purchased wall mounts that allow me to hang them off the wall, right by the outlet. This makes them inconspicuous while providing room filling sound. I just create zones in the Google Home app and then import them into Music Assistant. In my previous house, I had gone through the effort of installing ceiling speakers tied back to amps. It was a … Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23. | Reddit comment · 2022-09 | |
| Music Assistant multi-room audio | Works | Syncs many endpoint types for whole-home audioSaved copyWhats wrong with you people? Music Assistant syncs many types of endpoints Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23. | Reddit comment · 2024-05 | |
| Sonos speakers | Works | Suggested as most complete, easiest whole-home audio option through HASaved copysonos will probably the most complete and easiest way to do this through ha. Ikea also has sonus knock offs that are cheaper. Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23. | Reddit comment · 2024-02 | |
| WiiM Pro / WiiM Mini | Works Local | Play perfectly with Music Assistant; multiple users recommendSaved copyMusic Assistant is awesome! Have you seen the WiiM devices? Check out the WiiM Pro (has Ethernet for stability) or the WiiM Mini (cheaper/Wi-Fi). Both play perfectly with MA and sound crystal clear. Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23. | Reddit comment · 2026-01 | |
| WiiM streamers/amps | Works Local | Many users: flawless sync, works well with Music Assistant, cheaper than SonosSaved copyI can vouch for Wiim as well! I have 7 Wiim Pros and the sync is flawless. And they work well with Music Assistant! Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23. | Reddit comment · 2026-05 | |
| HomePod mini stereo pair | Not working Local | HA separates stereo pairs; Music Assistant support asked aboutSaved copyIt’s been a while since I did it, but I think all of my HomePods came into HA when I added the Apple TV integration, or at least that’s where they’re listed now? Things seemed to work pretty well when I setup music library for HA and I could to play to all or any of them. It’s just that HA separates the pairs, and besides losing the stereo effect, I had trouble controlling the pairs from HomeKit after that. Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23. | Reddit comment · 2025-12 | |
| NVIDIA Shield Pro | Not working | Shows as player but won't play; stream server IP fix suggestedSaved copyoh Music Assistant, I want to love you so badly but I can't get you to play. I just can't get MA to play sounds. The whole process is clear as mud, unlike all my other experiences with HA. I have an NVIDIA shield pro hooked up to HA with Google Cast, ADB, and Android TV Remote all working. (for example, I can display picture-in-picture video from HA). In HA, the shield shows up as a player, and I added it to MA. But... it won't play. I also tried an rpi0w running picoreplayer connected to wifi using a bluetooth speaker and very similar thing, it seems to think it is playing but I get no … Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23. | Reddit thread · 2024-12 | |
| Alexa devices via Music Assistant | Won’t be supported | Music cannot be played this way; Amazon limitation, now clear errorSaved copyThe problem No matter what I try to play from Music Assistant, I get the same message: Alexa says: "to send tts, please set announce=true. Music can't be played this way" ### What version of Home Assistant Core has the issue? core-2024.12.1 ### What was the last working version of Home Assistant Core? _No response_ ### What type of installation are you running? Home Assistant OS ### Integration causing the issue Music Assistant ### Link to integration documentation on our website https://www.home-assistant.io/integrations/music_assistant ### Diagnostics information … Excerpt saved from GitHub on 2026-10-23. | Issue #132579 · 2024-12 |
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
Local push
Talks to the device on your network, and the device tells Home Assistant the moment something changes.
Found automatically over
- Bonjour (zeroconf)
Details
| Installs (analytics) | 60,191 (8.49%) |
|---|---|
| Quality scale | Bronze |
| Added in | Home Assistant 2024.12 |
| Set up in the UI | Yes |
| Maintainers | @music-assistant, @arturpragacz |
Limitations from the docs
- The data returned by the getqueue` action will be partially limited if the item is not in the library (For example, if an item was selected for playback directly from Spotify). Metadata such as favorite status, explicit status, last played, played count, and disc art URL are only available for items that are in the MA …
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.
