# \[APP\]\[Pro & Server\] Music Assistant

**URL:** <https://community.homey.app/t/app-pro-server-music-assistant/151738>\
**Category:** Apps\
**Created:** [February 26, 2026, 7:39pm UTC](https://community.homey.app/t/app-pro-server-music-assistant/151738 "2026-02-26T19:39:56Z")\
**Posts on this page:** 20\
**Page:** 1

<div class="post-metadata">

**Author:** ![Cyril\_Hendriks](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/cyril_hendriks/32/83945_2.png) [@Cyril\_Hendriks](https://community.homey.app/u/Cyril_Hendriks)\
**Post date:** [February 26, 2026, 7:39pm UTC](https://community.homey.app/t/app-pro-server-music-assistant/151738/1 "2026-02-26T19:39:56Z")

</div>

# Music Assistant for Homey

Control your [Music Assistant](https://www.music-assistant.io) speakers from Homey: start music from flows, make announcements, and see what’s playing on your dashboard.

Music Assistant is an open-source music server that brings your streaming services, local library and radio together, and plays them on Sonos, AirPlay, Chromecast and many other speakers. It runs locally, for example as a Home Assistant add-on or in Docker.

> **[Music Assistant | Homey](https://homey.app/en-us/app/com.cyrilhendriks.musicassistant/Music-Assistant/)**
>
> Manage all your smart speakers with Music Assistant and Homey.

## What you get

**Your speakers as Homey devices**  
Every Music Assistant player can be added as a device, with play/pause, next/previous, volume, shuffle and repeat, and the current title, artist, album and cover on the tile.

**Flows**

- Play a track, album, artist, playlist, radio station or the latest episode of a podcast
- Speak text on one or more speakers, optionally with a fixed volume and chime, or in a specific language
- Play a sound from a URL as an announcement
- Group and ungroup speakers, or move the music to another speaker
- Clear the queue, add the current track to your favorites, turn “Don’t stop the music” on or off
- Triggers when the title, artist or cover changes, or when the queue runs empty, and a condition on the number of items in the queue

**Dashboard widgets**

- **Search & Play:** search your music and play it on any speaker. The Discover tab shows Music Assistant’s own Discover page, with the same rows in the same order. You change that page in Music Assistant itself, and you can pick per widget whose page it shows.
- **Party QR:** guests scan a QR code and request songs from their own phone.

## Requirements

- Homey Pro (the app connects to Music Assistant on your local network)
- Music Assistant 2.9 or 2.10; the Discover tab needs 2.10

The app finds your server automatically on most networks. If it doesn’t, enter the address and port (usually 8095) in the app settings. The connection test there shows whether everything works.

## Authentication

The app needs a long-lived access token (bearer token) from Music Assistant. With it, the app can control your speakers and queues.

Create one in Music Assistant:

Settings → Users → User menu (⋯) → Access tokens → New token

Copy the token and paste it into the app settings in Homey. Treat it like a password: anyone with the token can control your Music Assistant.

The token belongs to the user who created it. The Discover tab shows that user’s Discover page unless you pick another user in the widget settings. Picking another user needs a token from an admin user.

## Announcements

By default Homey renders the spoken text itself and sends it to Music Assistant as audio. If you have a text-to-speech engine set up in Music Assistant, you can let Music Assistant speak instead (setting in the app). Test that engine in Music Assistant first; if you only hear the chime, turn the setting off again.

## Problems or ideas?

Post them in this topic. For a problem, please include:

- the app version and your Music Assistant version
- which speaker (type) it happens on
- what you did and what happened
- if possible, the Music Assistant log from around that moment

What changed in each version is in the changelog on the app page.

---

<div class="post-metadata">

**Author:** ![smarthomesven](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/smarthomesven/32/79712_2.png) [@smarthomesven](https://community.homey.app/u/smarthomesven)\
**Post date:** [February 26, 2026, 7:53pm UTC](https://community.homey.app/t/app-pro-server-music-assistant/151738/2 "2026-02-26T19:53:50Z")

</div>

Remove the “& Cloud” part from your topic title, community apps are not supported on Homey Cloud.

---

<div class="post-metadata">

**Author:** ![Cyril\_Hendriks](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/cyril_hendriks/32/83945_2.png) [@Cyril\_Hendriks](https://community.homey.app/u/Cyril_Hendriks)\
**Post date:** [February 26, 2026, 8:51pm UTC](https://community.homey.app/t/app-pro-server-music-assistant/151738/3 "2026-02-26T20:51:50Z")

</div>

Indeed, I meant server. Thanks for notifying.

---

<div class="post-metadata">

**Author:** ![Jonathan\_Draper](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/jonathan_draper/32/33978_2.png) [@Jonathan\_Draper](https://community.homey.app/u/Jonathan_Draper)\
**Post date:** [March 3, 2026, 9:36am UTC](https://community.homey.app/t/app-pro-server-music-assistant/151738/4 "2026-03-03T09:36:31Z")

</div>

Just found this and I think it might be the answer to all my prayers! In the UK it’s super hard to get BBC radio stations playing on HomePods without manually streaming from a device, which is not ideal from an automation perspective. Up to now I have been using OwnTone running on an RPi and then I was manually calling the API from flows. This is so much neater and more convenient and the artwork and metadata work right out of the box, plus integration with Apple Music, BBC Sounds and so many more. It’s just awesome. I got this set up and working in about 15 mins start to finish including a brand new Home Assistant install on a Mac, then Music Assistant on top and then installing and configuring the Homey app.

Just amazing work. Thank you.

Have donated!

---

<div class="post-metadata">

**Author:** ![Cyril\_Hendriks](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/cyril_hendriks/32/83945_2.png) [@Cyril\_Hendriks](https://community.homey.app/u/Cyril_Hendriks)\
**Post date:** [March 3, 2026, 10:11am UTC](https://community.homey.app/t/app-pro-server-music-assistant/151738/5 "2026-03-03T10:11:12Z")

</div>

Thank you very much for your donation! If you have any ideas on how to improve the app further, please let me know 🙂

---

<div class="post-metadata">

**Author:** ![Jonathan\_Draper](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/jonathan_draper/32/33978_2.png) [@Jonathan\_Draper](https://community.homey.app/u/Jonathan_Draper)\
**Post date:** [March 3, 2026, 11:37am UTC](https://community.homey.app/t/app-pro-server-music-assistant/151738/6 "2026-03-03T11:37:18Z")

</div>

Thanks @Cyril_Hendriks

Just playing with this - do you have a good solution for having a doorbell chime interrupting playing music? Speak text does this natively really nicely and resumes play afterwards automatically. I can use a doorbell chime track for doorbell events but then how to get what was playing before to resume? I’ve managed this using advanced flow for Radio by checking whether the speaker is playing, checking if the track = name of my radio station and then if so, playing that station 4s after triggering the doorbell track. That works very well, but would be amazing to do the same when interrupting a music track and to be able to resume where it left off in the track. I can’t immediately see a way to achieve that.

---

<div class="post-metadata">

**Author:** ![Cyril\_Hendriks](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/cyril_hendriks/32/83945_2.png) [@Cyril\_Hendriks](https://community.homey.app/u/Cyril_Hendriks)\
**Post date:** [March 3, 2026, 3:05pm UTC](https://community.homey.app/t/app-pro-server-music-assistant/151738/7 "2026-03-03T15:05:17Z")

</div>

Good idea! I will have a look into this 🙂

---

<div class="post-metadata">

**Author:** ![Cyril\_Hendriks](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/cyril_hendriks/32/83945_2.png) [@Cyril\_Hendriks](https://community.homey.app/u/Cyril_Hendriks)\
**Post date:** [March 3, 2026, 4:15pm UTC](https://community.homey.app/t/app-pro-server-music-assistant/151738/8 "2026-03-03T16:15:01Z")

</div>

I have created a new test version of the app with a new flow card type to play any sound (via a url) that works exactly the same as the speech announcements. It’s now in test and when I’m sure that nothing has been broken, I will push it to PRD 🙂

---

<div class="post-metadata">

**Author:** ![Jonathan\_Draper](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/jonathan_draper/32/33978_2.png) [@Jonathan\_Draper](https://community.homey.app/u/Jonathan_Draper)\
**Post date:** [March 3, 2026, 5:07pm UTC](https://community.homey.app/t/app-pro-server-music-assistant/151738/9 "2026-03-03T17:07:16Z")

</div>

Awesome! Thanks for super quick turn around. I will give this a test and let you know how I get on.

---

<div class="post-metadata">

**Author:** ![Jonathan\_Draper](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/jonathan_draper/32/33978_2.png) [@Jonathan\_Draper](https://community.homey.app/u/Jonathan_Draper)\
**Post date:** [March 3, 2026, 5:48pm UTC](https://community.homey.app/t/app-pro-server-music-assistant/151738/10 "2026-03-03T17:48:31Z")

</div>

New card seems to work perfectly in my testing, thanks again.

One other little thing: I notice when streaming BBC Radio 4 (I’m using the Music Assistant BBC Sounds integration), I see that Music Assistant itself has metadata about the current programme (which in this case is a programme called “PM”, listed with its running times as “17:00 - 18:00 PM”) (see screenshot from Music Assistant below) but that doesn’t seem to come through to Homey (see 2nd screenshot below taken at the same time as the first). Are there any other items of metadata that could be fed through? I don’t see an ‘Album’ tag for example. Since the metadata items aren’t labelled in the Music Assistant UI it’s hard to know which are which, but I see there’s already an Artist tag in Homey and that’s blank while BBC Radio 4 is streaming so it doesn’t seem to be that.

 ![Screenshot 2026-03-03 at 17.45.38](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/f/7/f7db2ac87ca4e8844472e9ee495ae389f8bfb1af.jpeg)

 ![Screenshot 2026-03-03 at 17.46.04](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/9/0/90ca3db3299421c67a7bb527ab96a12f9bf47ef6.jpeg)

Thanks again!

---

<div class="post-metadata">

**Author:** ![Cyril\_Hendriks](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/cyril_hendriks/32/83945_2.png) [@Cyril\_Hendriks](https://community.homey.app/u/Cyril_Hendriks)\
**Post date:** [March 3, 2026, 7:12pm UTC](https://community.homey.app/t/app-pro-server-music-assistant/151738/11 "2026-03-03T19:12:19Z")

</div>

Getting the metadata right is still an ongoing struggle. May I ask you which service you use in Music Assistant to stream BBC Radio 4? I will check which metadata I can send to Homey.

---

<div class="post-metadata">

**Author:** ![Peter\_Kawa](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/peter_kawa/32/173848_2.png) [@Peter\_Kawa](https://community.homey.app/u/Peter_Kawa)\
**Post date:** [March 3, 2026, 7:38pm UTC](https://community.homey.app/t/app-pro-server-music-assistant/151738/12 "2026-03-03T19:38:24Z")

</div>

Oww, that’s how you discover something  
Great system!

The 3rd longlived token made it all happen 🤓

---

<div class="post-metadata">

**Author:** ![Jonathan\_Draper](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/jonathan_draper/32/33978_2.png) [@Jonathan\_Draper](https://community.homey.app/u/Jonathan_Draper)\
**Post date:** [March 3, 2026, 7:41pm UTC](https://community.homey.app/t/app-pro-server-music-assistant/151738/13 "2026-03-03T19:41:29Z")

</div>

Thank you - I’m using the BBC Sounds service in Music Assistant for this

 ![Screenshot 2026-03-03 at 19.41.43](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/0/2/0288b7091d9d13f94f464506ffb1d7800fc1531f.png)

---

<div class="post-metadata">

**Author:** ![Jonathan\_Draper](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/jonathan_draper/32/33978_2.png) [@Jonathan\_Draper](https://community.homey.app/u/Jonathan_Draper)\
**Post date:** [March 3, 2026, 8:29pm UTC](https://community.homey.app/t/app-pro-server-music-assistant/151738/14 "2026-03-03T20:29:46Z")

</div>

By the way @Cyril_Hendriks I found something weird while testing which might shed some light on the metadata thing. I tried playing radio 4 on one speaker and then using the ‘add speaker’ card to play it on another. This worked and while the metadata on the first speaker looked exactly like the screenshot above, the metadata on the second had the programme artwork instead of the generic radio station artwork and also it showed the programme info! Like this:

 ![IMG_3970](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/1/5/154210ef6973100edb9014df5881ced49112a821.jpeg)

 ![IMG_3971](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/e/6/e6b8f9675da36b3d49d789c7d2c7715a5c34e324.jpeg)

---

<div class="post-metadata">

**Author:** ![Cyril\_Hendriks](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/cyril_hendriks/32/83945_2.png) [@Cyril\_Hendriks](https://community.homey.app/u/Cyril_Hendriks)\
**Post date:** [March 4, 2026, 9:51am UTC](https://community.homey.app/t/app-pro-server-music-assistant/151738/15 "2026-03-04T09:51:34Z")

</div>

Hi Jonathan, that you for your testing efforts. I will have a look into this next week the latest. I have some busy days upcoming.

---

<div class="post-metadata">

**Author:** ![Cyril\_Hendriks](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/cyril_hendriks/32/83945_2.png) [@Cyril\_Hendriks](https://community.homey.app/u/Cyril_Hendriks)\
**Post date:** [March 4, 2026, 9:54am UTC](https://community.homey.app/t/app-pro-server-music-assistant/151738/16 "2026-03-04T09:54:18Z")

</div>

Hi Peter, thank you! 🙂 Happy to see that you managed to connect MA with Homey. 🙂

---

<div class="post-metadata">

**Author:** ![Cyril\_Hendriks](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/cyril_hendriks/32/83945_2.png) [@Cyril\_Hendriks](https://community.homey.app/u/Cyril_Hendriks)\
**Post date:** [March 5, 2026, 8:33pm UTC](https://community.homey.app/t/app-pro-server-music-assistant/151738/17 "2026-03-05T20:33:27Z")

</div>

I think I managed to fix it in the latest test build: \* Link: [Music Assistant | Homey](https://homey.app/en-be/app/com.cyrilhendriks.musicassistant/Music-Assistant/test/) 🙂

---

<div class="post-metadata">

**Author:** ![Jonathan\_Draper](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/jonathan_draper/32/33978_2.png) [@Jonathan\_Draper](https://community.homey.app/u/Jonathan_Draper)\
**Post date:** [March 5, 2026, 8:53pm UTC](https://community.homey.app/t/app-pro-server-music-assistant/151738/18 "2026-03-05T20:53:25Z")

</div>

Looking good! Amazing work thanks @Cyril_Hendriks

 ![IMG_3973](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/b/4/b412143f286b59027796f40d65cedce9f91dc971.jpeg)

---

<div class="post-metadata">

**Author:** ![Jonathan\_Draper](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/jonathan_draper/32/33978_2.png) [@Jonathan\_Draper](https://community.homey.app/u/Jonathan_Draper)\
**Post date:** [March 5, 2026, 8:58pm UTC](https://community.homey.app/t/app-pro-server-music-assistant/151738/19 "2026-03-05T20:58:26Z")

</div>

One more idea for you. Absolutely no rush, but it would be awesome to have some flow cards for controlling podcasts. I’m thinking:

- play latest episode of 
- Play random episode of 
- Play all episodes of (Could then be put on shuffle mode if desired)

I’ve switched over to using this app now for 9 speakers for radio, music, doorbell and announcements full time so giving it a thorough soak test. Loving it, so many more use cases opened up with this. Where has this app been all my life?!

---

<div class="post-metadata">

**Author:** ![Cyril\_Hendriks](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/cyril_hendriks/32/83945_2.png) [@Cyril\_Hendriks](https://community.homey.app/u/Cyril_Hendriks)\
**Post date:** [March 5, 2026, 9:17pm UTC](https://community.homey.app/t/app-pro-server-music-assistant/151738/20 "2026-03-05T21:17:56Z")

</div>

Nice ideas indeed. I’ll have a look at that 🙂 My first priority might be a bit more boring, but I want to make the app more efficient, since it’s consuming quite some memory 😊

[Next page](https://community.homey.app/t/app-pro-server-music-assistant/151738.md?page=2)
