AUX

npx -y spotify-aux demo
npx -y spotify-aux login

Then in Cursor: “rainy 2am drive” · “roast my top tracks” · “start auto DJ”

60-second setup

1. Spotify Dashboard → create app

2. Redirect URI (exact):

http://127.0.0.1:7654/callback

(Optional roast site later: also add http://127.0.0.1:7656/)

3. Install & login:

npm i -g spotify-aux
# or: git clone … && npm i && npm run build
export SPOTIFY_CLIENT_ID=…
export SPOTIFY_CLIENT_SECRET=…
npx -y spotify-aux login

4. Cursor MCP config:

{
  "mcpServers": {
    "aux": {
      "command": "npx",
      "args": ["-y", "spotify-aux"],
      "env": {
        "SPOTIFY_CLIENT_ID": "your_id",
        "SPOTIFY_CLIENT_SECRET": "your_secret"
      }
    }
  }
}

From a local clone, point command/args at node + dist/server.js instead.

Related MCP server: spotify-mcp-server

Peak hooks

Every hook can drop an ASCII card made for screenshots.

Party with friends

# host machine
npx -y spotify-aux party-host
# tunnel it, e.g. cloudflared tunnel --url http://127.0.0.1:7655

# everyone
export AUX_PARTY_RELAY=https://your-tunnel.example

Then party_room_create → share the code → friends party_room_add / party_room_vote.

Roast site (no MCP)

npx -y spotify-aux web
# open http://127.0.0.1:7656

Full tool map

See Architecture for the tool-module, Spotify endpoint, authentication, and vibe-pipeline map.

vibe · context_vibe · weekly_report · auto_dj_start · auto_dj_tick · auto_dj_stop · auto_dj_status · party_room_create · party_room_join · party_room_add · party_room_vote · party_room_play_winner · set_mood · adjust_playlist_vibe · roast_my_playlist · playlist_dna · aux_battle · blend_tastes · music_compatibility · whats_playing_story · party_* · record_taste_feedback · get_taste_memory · auth_status

Search, browse, playback, playlists, library, personalization — full Web API surface so the agent never stalls mid-task.

CLI

npx -y spotify-aux              # MCP server
npx -y spotify-aux login
npx -y spotify-aux status
npx -y spotify-aux autodj       # refill loop
npx -y spotify-aux party-host   # friend relay :7655
npx -y spotify-aux web          # roast site :7656
npx -y spotify-aux demo

After npm i -g spotify-aux, binaries: spotify-aux and aux-mcp.

Auth

Tokens → ~/.aux-mcp/. Premium + open Spotify app for playback.

OpenClaw

Register AUX as an OpenClaw-managed MCP server + install the skill:

npx -y spotify-aux 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

ClawHub: @brian-mwirigi/aux-mcp · skill: skills/aux-mcp/SKILL.md · docs/openclaw.md

Contributing

PRs welcome. See CONTRIBUTING.md and open good first issues.

Site: brianmunene.me/aux-mcp

Star it. Pass the aux.

github.com/brian-mwirigi/aux-mcp

MIT