Works with the AI tools you already use

    CClaude CodeCCursorCCodex CLIGGitHub CopilotGGemini CLI+17 more

    music assistant automation

    by Marv B

    2

    Control your self-hosted Music Assistant server from any AI agent — search and play tracks on AirPlay, HomePod, Sonos and more speakers via simple API calls.

    Secure checkout via Stripe

    0 installsSecurity scanned

    See it in action

    You say

    Play the song 'Blue Monday' by New Order on the Living Room speaker and set the volume to 30%.

    Your agent does

    Searching for 'Blue Monday' by New Order... Found track on Spotify. Sending play command to Living Room (ID: living_room_123). Setting volume to 30%. Playback started.

    What you get

    Control multi-room audio systems like Sonos and Chromecast via terminal.Search across multiple providers like Spotify and local files simultaneously.Manage speaker volumes and playback states without a graphical interface.

    About this skill

    🎵 Control your self-hosted Music Assistant server from any compatible AI coding agent — Claude Code, Codex CLI, Cursor, VS Code Copilot, and more.

    This skill gives your AI agent hands-on control over your existing Music Assistant setup (Spotify, Internet Archive, local library, AirPlay, UPnP, HomePod, Chromecast, Sonos). One natural-language prompt is enough: "play Tame Impala on Living Room", "pause Küche", "set Bedroom volume to 25".

    ✨ Highlights • Works with YOUR self-hosted MA server — no cloud signup, no extra service • Supports 25+ providers: Spotify, Internet Archive, radio, local files, podcasts • Multi-room audio (groups, individual control, sync playback) • Built-in playback control (play/pause/skip/volume/queue/shuffle/repeat) • Best-practice error handling around Music Assistant API gotchas (constructor signature, WebSocket listener lifecycle, Spotify URI prefix)

    🛠 Requirements • A self-hosted Music Assistant server (v2.x — Home Assistant add-on, Docker, or standalone). Free & open source: https://music-assistant.io • A long-lived API token from MA Settings → Users → Create token • Local network reachability from agent → MA server (usually LAN)

    🔌 Setup (one-time)

    1. Install dependencies: pip install music-assistant-client websockets aiohttp orjson
    2. Store your MA token securely (env var MUSIC_ASSISTANT_TOKEN, or ~/.ma_token with chmod 600). Never paste into chat.
    3. Run the included ma-play.py "Daft Punk" --player "Living Room" --dry-run to verify connection
    4. Start scripting — see SKILL.md for full pattern

    🏠 Perfect for Home Assistant users Music Assistant is a popular HA add-on. Combine both for music automation from any HA script or scene.

    📦 What's included • SKILL.md — main skill definition with onboarding wizard • references/api-gotchas.md — detailed API gotchas + verified working examples • scripts/ma-play.py — minimal CLI for search-and-play (great for testing)

    How to install

    Drop the file into your AI Agent. Works with Claude, Cursor, ChatGPT, and 20+ more.

    Reviews

    No reviews yet

    Be one of the first to try it. Every listed skill passes our trust checks below.

    Security scanned

    Passed our 8-point scan before listing

    Fresh listing

    Recently published to Agensi

    30-day refund

    Not a fit? Get your money back

    Trust & safety

    Security scanned

    Verified clean 1 month ago

    Listed1 month ago

    Creator

    M

    Marv B

    Frequently Asked Questions

    Popular in AI Agents & LLM Ops