Skip to content

Settings → AI holds the default AI engines, what uses AI, your AI services and access for AI assistants. Only administrators see it.

Some features need an engine to do their work: an AI engine writes text, a text-to-speech engine speaks it and an image engine draws pictures. Engines come from AI services, which are plugins. The OpenAI Compatible plugin provides AI and image engines, the OpenAI Text-to-speech plugin provides text-to-speech engines, and the Home Assistant plugin turns the AI task and text-to-speech entities of your Home Assistant into engines.

  • Default AI engine. The AI engine every feature uses unless it picks one of its own, for example to write playlist descriptions or AI Radio breaks
  • Default text-to-speech engine. The text-to-speech engine every feature uses unless it picks one of its own, for example to speak announcements or AI Radio breaks
  • Default image engine. The image engine every feature uses unless it picks one of its own, for example to draw playlist covers

Only a kind that has engines gets a picker. A kind without one shows a message instead, which says what kind of plugin to set up. The first engine available of a kind becomes its default, so with one engine of each kind there is nothing to choose.

Engines are named after the AI service and then the engine, as <service> | <engine>, so two similar engines can be told apart. If the engine of a default disappears, for example because its plugin was removed, Music Assistant reports it rather than switching to a different one. Choose another one, or bring back the plugin that provides it.

With no engines at all, the page shows No AI engines yet instead, with Add an AI service, which lists the services that can provide engines, such as OpenAI Compatible and Home Assistant, and sets up the one you pick right on the page.

This list shows every feature that is set up and uses an engine, with the kind of engine it needs. Pick the engine right on its row, with the same options as the feature’s own picker, and the choice is saved straight away. A row shows Not available when there is no engine for it, and The selected engine is not available under its picker when the engine it uses is gone. AI Radio keeps its engines in its setup, so its rows show the engine it uses, with Default · followed by the engine’s name when it follows the default, and open its Reconfigure.

FeatureKindWhere else to change it
PlaybackText-to-speech, for announcementsAnnouncement text-to-speech engine on Settings → Players → Playback
AI RadioAI and text-to-speechReconfigure on the plugin’s menu, not its normal settings. See changing the engines later
Music QuizAIIts settings, under Features
Smart PlaylistsAIIts settings, once AI descriptions is switched on
Playlist MetadataImage for covers, AI for descriptionsIts settings: Image engine appears once Artwork template is AI generated, and Text engine is under AI covers and descriptions

A feature’s own picker starts on its first option, which follows the default engine and carries that engine’s name. Pick another engine there to give that feature its own.

This list holds the AI services that are set up, each with what it provides, such as 2 text · 1 image. A service that provides nothing shows Choose the models to use, for example an OpenAI Compatible plugin without models. The Home Assistant plugin is listed while Home Assistant has an AI task or text-to-speech entity.

Select a service to open its settings, which for Home Assistant are on Settings → System → Home Assistant. Add an AI service adds another one, right on this page.

  • Enable the built-in MCP server. Switches the MCP server built into Music Assistant on or off. It is on by default. With it on, AI assistants such as Home Assistant Assist, Claude and ChatGPT can search your music and control playback through the Model Context Protocol (MCP)

For more control, such as a connect wizard for AI clients and token policies, see the community MCP server plugin, listed in the Marketplace as MCP Server (Community).

This website uses privacy-first analytics to help us improve the site. You can view all data in our public dashboard.