--- title: "Music Assistant" description: "Music Assistant is a built-in integration for Home Assistant. It has 60.7k installs sharing analytics and works locally." canonical: "https://vulpo.app/integrations/core/music-assistant" url: "https://vulpo.app/integrations/core/music-assistant.md" last-updated: "2026-10-22" version: "1.4" --- # Music Assistant > Music Assistant is a built-in integration for Home Assistant. It has 60.7k installs sharing analytics and works locally. Music Assistant is a built-in integration that connects Home Assistant to a Music Assistant server for music playback and control. It communicates locally and is set up in the UI with the server URL and a long-lived access token. Home Assistant can discover the server on the network and offer to add it. The integration provides media player entities along with a button to favorite the current song, number controls such as bass, treble and subwoofer volume, selects such as equalizer mode and sleep timer, switches such as party mode and pure direct, and a text field for the network name. Actions cover playing media and announcements with finer control, searching the library and all providers, getting library items, reading the active queue details of a player, and transferring a queue to another player. New devices appear without repeating setup, removed devices are cleaned up, and a repair notice appears if the server version is wrong. Automatic summary of Home Assistant's source code. Something wrong? [Get in touch](https://vulpo.app/contact) [Open in My Home Assistant](https://my.home-assistant.io/redirect/config_flow_start/?domain=music_assistant) ## Supports - **Works locally**: Talks to your devices on your own network. No vendor cloud in between. - **Set up in the UI**: Add it in Settings, Devices and services. Nothing to download. - **Found by itself**: Home Assistant spots it on the network and offers to add it. - **Adds new devices**: New devices show up without setting it up again. - **Cleans up devices**: Devices that are gone are removed by themselves. - **Bronze quality**: Home Assistant's own rating of its code and setup experience. - **Updated with Home Assistant**: Ships and updates with every Home Assistant release. ## Setting it up Home Assistant usually finds it on the network and offers to add it. It can also be added by hand under Settings, Devices and services. ### Connect - **URL**: URL of the Music Assistant server ### Enter long-lived access token - **Long-lived access token**: Create a long-lived access token in your Music Assistant server settings and paste it here Texts from Home Assistant's source code, [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ## Entities - **Buttons**: Favorite current song - **Numbers**: Bass, Dialogue level, Dialogue lift, DTS dialogue control, Equalizer high, Equalizer low, Equalizer mid, Subwoofer volume, Treble - **Selects**: Dimmer, Equalizer mode, Link audio delay, Link audio quality, Link control, Sleep timer, Surround decoder type, Tone control mode - **Switches**: Adaptive DRC, Bass extension, Clear voice, Enhancer, Extra bass, Party mode, Pure direct, Speaker A, Speaker B, Surround 3D - **Texts**: Network name ## Actions - **Get library items**: Retrieves items from a Music Assistant library. Fields: Enable album artists filter (only for artist library), Album type filter (albums library only), Music Assistant instance, Favorites only, Limit, Media type, Offset, Order by, Search, Username - **Get playerQueue details**: Retrieves the details of the currently active queue of a Music Assistant player. - **Play announcement**: Plays an announcement on a Music Assistant player with more fine-grained control options. Fields: Announce volume, Message, Pre-announce URL, Text-to-speech entity, URL, Use pre-announce - **Play media**: Plays media on a Music Assistant player with more fine-grained control options. Fields: Album name, Artist name, Enqueue, Media ID(s), Media type, Enable radio mode, Username - **Search Music Assistant**: Performs a global search on the Music Assistant library and all providers. Fields: Album name, Artist name, Music Assistant instance, Only library items, Limit, Media type(s), Search name, Username - **Transfer queue**: Transfers a player's queue to another player. Fields: Autoplay, Source media player ## Troubleshooting - **Repair notices**: Notices it can show in Settings, Repairs: The Music Assistant server is not the correct version ## At a glance - Kind: Built-in integration - Category: [Media and entertainment](https://vulpo.app/integrations/category/media-and-entertainment.md), Music and radio services - Brand: [Music Assistant](https://vulpo.app/integrations/music-assistant.md) - Number: 60.7k installs sharing analytics - Connection: Works locally - Upkeep: Part of Home Assistant - Needs: Built into Home Assistant - Quality scale: Bronze quality scale - Domain: `music_assistant` - Source: In Vulpo: Media Player card, Up Next queue with editing, Move playback to another speaker, Intercom volume (Pro) [Intercom for Home Assistant Speakers in Vulpo](https://vulpo.app/features/intercom) ## Other ways in for Music Assistant | Name | Kind | Installs or stars | Connection | Upkeep | | --- | --- | --- | --- | --- | | [Music Assistant Queue Actions](https://vulpo.app/integrations/marketplace/droans-mass-queue.md) | Marketplace integration | 2.6k installs sharing analytics | Works locally | Updated in the last 6 months | | [Music Assistant](https://vulpo.app/integrations/apps/music-assistant.md) | App | 61k installs sharing analytics | Connection not stated | Updated in the last 6 months | | [Music Assistant Player Card](https://vulpo.app/integrations/cards/droans-mass-player-card.md) | Dashboard card | 138 GitHub stars | Connection not stated | Updated in the last 6 months | | [Music Assistant Queue Card](https://github.com/droans/mass_card) | Dashboard card | 16 GitHub stars | Connection not stated | No update in 6 to 18 months | | [Music Assistant Album Grid](https://github.com/urbanframe/mass-album-grid) | Dashboard card | No installs sharing analytics yet | Connection not stated | Updated in the last 6 months | Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about) Last updated 2026-10-22. Source: https://vulpo.app/integrations/core/music-assistant --- - HTML version of this page: https://vulpo.app/integrations/core/music-assistant - Site index for agents: https://vulpo.app/llms.txt - Everything in one document: https://vulpo.app/llms-full.txt - All pages: https://vulpo.app/sitemap.xml