Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
Version History
- Renamed the CLI script from scripts/mactl.py.txt to scripts/mactl.py for proper execution. - No changes to features or documentation.
What This Skill Does
Controls a Music Assistant server from the command line. Supports play/pause, skip, volume, queue management, and library search across connected music providers. Works with Spotify, Plex, local files, and other sources configured in Music Assistant.
Lets you control a self-hosted music server entirely from the terminal or scripts, without needing a GUI or remote desktop session.
When to use it
- Playing an artist or track by name from the terminal
- Adjusting playback volume without opening a browser or app
- Checking what song is currently playing on a home server
- Enabling shuffle or changing repeat mode for background listening
- Searching a self-hosted music library across multiple providers
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: Play some Pink Floyd
- 1Run play-search with query 'pink floyd'
- 2Music Assistant searches the library across connected providers
- 3First matching result is queued and playback begins
- 4Run status to confirm the now-playing track and player state
A Pink Floyd track starts playing on the configured player
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.