AUX — Spotify for your AI
You have AUX (spotify-aux) — a full Spotify MCP server plus peak DJ hooks.
YOU are the vibe model. Do not use a hardcoded mood dictionary. Invent search queries and audio targets from the user's words.
Site: https://brianmunene.me/aux-mcp · npm: spotify-aux · GitHub: https://github.com/brian-mwirigi/aux-mcp
Setup (once)
npm i -g spotify-aux
npx spotify-aux login # PKCE → ~/.aux-mcp/
Register the MCP server with OpenClaw:
openclaw mcp add aux \
--command npx \
--arg -y \
--arg spotify-aux \
--env SPOTIFY_CLIENT_ID="$SPOTIFY_CLIENT_ID" \
--env SPOTIFY_CLIENT_SECRET="$SPOTIFY_CLIENT_SECRET"
openclaw mcp doctor aux --probe
Or install this skill into managed skills:
npx spotify-aux openclaw
# copies skills/aux-mcp/SKILL.md → ~/.openclaw/skills/aux-mcp/SKILL.md
Redirect URI (exact): http://127.0.0.1:7654/callback
Playback needs Spotify Premium + an active device. Search/browse can work with client credentials alone.
When to use
| User says | Do this |
|---|---|
| Mood / vibe / “play something like…” | vibe with invented search_queries + energy/valence/tempo |
| “Music Spotify won’t show me” | vibe with anti_algorithm=true |
| “DJ for right now” / weather / time | context_vibe |
| “Roast my playlist / top tracks” | roast_my_playlist |
| “What’s the DNA of this playlist” | playlist_dna |
| “Keep it going” | auto_dj_start (user may also run npx spotify-aux autodj) |
| Party / friends queue | party_room_* (+ host may run npx spotify-aux party-host) |
| “What’s playing” story | whats_playing_story |
| Weekly taste recap | weekly_report |
Always surface ASCII cards from tool results when present (vibe / roast / DNA / battle / party / weekly).
Vibe contract
Call vibe with:
text— the user’s mood linesearch_queries— 3–6 queries you inventenergy,valence,tempo— targets you choose from the text- optional
anti_algorithm=trueto dodge top tracks + chart bait
Then queue / play as the user asks. Prefer showing the vibe card in your reply.
Example turns
User: rainy 2am drive
- Invent queries (e.g.
2am neo-soul rain,night drive alt r&b 90bpm, …) - Call
vibewith energy ~0.3, valence ~0.35, tempo ~92 - Paste / summarize the ASCII card
- Queue or play if they want it on speakers
User: roast my top tracks
roast_my_playlist- Return the roast card — keep the grade visible
CLI helpers (shell)
spotify-aux status
spotify-aux demo
spotify-aux web # roast site :7656
spotify-aux autodj # refill loop
spotify-aux party-host # friend relay :7655
spotify-aux openclaw # install this skill locally
Important
- Prefer MCP tools over inventing Spotify API calls yourself.
- Never print client secrets or
~/.aux-mcptokens. - If
auth_statussays not logged in → tell the user to runnpx spotify-aux login. - If playback fails → Premium + open Spotify on a device, then retry.
