home-assistant-music-assistant

Control Home Assistant Music Assistant playback and library from the command line.

Updated Jan 31, 2026
One-click install
npx skills add https://github.com/troykelly/openclaw-skill-music-assistant --skill home-assistant-music-assistant
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: home-assistant-music-assistant
Source: https://github.com/troykelly/openclaw-skill-music-assistant/tree/main/skills/home-assistant-music-assistant
Command: npx skills add https://github.com/troykelly/openclaw-skill-music-assistant --skill home-assistant-music-assistant

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Users need a lightweight, command-line way to control Home Assistant Music Assistant, bridging REST API capabilities with a local workflow.

Core Features & Use Cases

  • List speakers and view their status from Home Assistant
  • Discover, cache, and reference Music Assistant configuration
  • Browse and search the Music Assistant library and control playback
  • Manage playback memories, moods, preferences, and recent history from the terminal

Quick Start

Install dependencies and run the ha-ma CLI to manage Home Assistant Music Assistant from your terminal.

Frequently Asked Questions about home-assistant-music-assistant

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I control Home Assistant Music Assistant playback from the command line?

You can control Home Assistant Music Assistant playback from the command line using a CLI wrapper that lists speakers, browses the library, searches music, and issues playback commands from a local shell.

Can I browse the Music Assistant library and search for music without opening the web interface?

Yes, you can browse the Music Assistant library and search for music entirely from the terminal, enabling you to discover, cache, and reference configurations without relying on the web interface.

What do I need to connect a CLI tool to my Home Assistant Music Assistant instance?

To connect to Home Assistant Music Assistant, you need your HA_URL and a long-lived access token provided via either an HA_TOKEN_FILE or an HA_TOKEN_CMD environment variable.

Does the Home Assistant Music Assistant CLI support managing playback history and preferences?

Yes, the Home Assistant Music Assistant CLI supports managing playback memories, moods, preferences, and recent history directly from the terminal, with an optional MA_DB_PATH for reading local memory.

Why use a CLI wrapper instead of the Home Assistant REST API for Music Assistant?

A CLI wrapper bridges Home Assistant REST API capabilities with a local workflow, providing a lightweight, command-line way to control Music Assistant without manually constructing API requests.

Can I list connected speakers and check their status from a local shell using Music Assistant?

Yes, you can list speakers and view their current status from Home Assistant directly within your local shell using the command-line interface.