aux
AUX - Spotify for your AI. AI DJ, roast cards, party rooms and auto-DJ via MCP.
Brian Munene Mwirigi
@brian-mwirigi
What This Skill Does
MCP server that turns natural language mood descriptions into Spotify playlists and playback commands. Invent search queries, energy/valence/tempo targets, and optional anti-algorithm mode to avoid chart bait. Requires Spotify Premium for playback.
Replaces manually searching and queuing songs by letting you describe a vibe, time of day, or activity and getting a curated playlist instantly.
When to Use It
- Play music matching a mood like 'rainy 2am drive' or 'upbeat morning workout'
- Get a roast of your top tracks or a playlist with a grade and ASCII card
- Start an auto-DJ loop that refills the queue as songs end
- Create a party room where friends can queue songs via a shared link
- Pull a weekly taste recap showing your listening trends and top genres
- Analyze a playlist's DNA (energy, valence, tempo distribution)
Install
$ openclaw skills install @brian-mwirigi/aux-mcpAUX — 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.
Top skills in this category
YouTube
@byungkyuYouTube Data API integration with managed OAuth. Search videos, manage playlists, access channel data, and interact with comments. Use this skill when users want to interact with YouTube. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Calls run through the `maton` CLI with OAuth login, or over raw HTTP with a Maton API key where the CLI cannot be installed. Every call is authenticated as the user's connection and reaches only what that connection's authorization allows, which the provider enforces on every request; the endpoints documented here are the ones this skill uses, and any other endpoint of this app needs the user to ask for it by name. Default to read and list calls, and confirm every write or new connection with the user. This file also documents the three constructs that turn a YouTube connection into automation, in the order they are used: the connection (the first step), a hosted function that runs a YouTube action through the Maton SDK, and a trigger that calls that function on a schedule or on an event. Those sections are the platform's own reference text, shared with the api-gateway skill, with YouTube examples; they add no YouTube capability - YouTube is not an event source, a trigger cannot read YouTube data, and the files under `references/<source>/triggers.md` are the platform's event catalogues for the sources Maton offers (time, Calendly, GitHub, Gmail, HubSpot, Linear, Notion, Slack, Stripe).
Wechat Article Search
@wuchubuzai2018搜索微信公众号文章技能。通过微信搜索获取文章列表，覆盖科技/AI、社会热点、财经、教育、职场等各类中文资讯；可按关键词检索并返回标题、概要、发布时间、来源公众号与链接。当用户需要查找微信公众号文章、整理参考资料或快速获取文章信息时使用此技能。
Figma
@hith3shRead files, manage comments, extract design tokens, download images, and create webhooks in Figma via the Figma REST API. Use this skill when users want to i...
Social Media Scheduler
@1kalinPlan, draft, and organize social media content across platforms. Create content calendars, write platform-optimized posts, and maintain consistent posting schedules.
Alexa CLI
@buddyhControl Amazon Alexa devices and smart home via the `alexacli` CLI. Use when a user asks to speak/announce on Echo devices, control lights/thermostats/locks, send voice commands, or query Alexa.