Search Apple Music, add songs to library, manage playlists, control playback and AirPlay.
Control Apple Music via MusicKit API and AppleScript. Path: ~/.clawdbot/skills/apple-music/
Playback: ./apple-music.sh player [now|play|pause|toggle|next|prev|shuffle|repeat|volume N|song "name"]
AirPlay: ./apple-music.sh airplay [list|select N|add N|remove N]
Requires Apple Developer account ($99/yr) + MusicKit key.
Portal steps first:
Then run setup:
./launch-setup.sh # Opens Terminal for interactive setup
The launcher opens Terminal.app and runs the setup script there. Enter your .p8 path, Key ID, Team ID, then authorize in browser and paste the token.
⚠️ Agents: Always use ./launch-setup.sh to open Terminal. Don't run setup.sh through chat (requires interactive input).
search "query" [--type songs|albums|artists] [--limit N]library add <song-id>playlists [list|create "Name"|add <playlist-id> <song-id>]config.json stores tokens (valid ~6 months). Re-run ./setup.sh if auth fails.
| Error | Cause | Solution |
|---|---|---|
401 Unauthorized | Token expired or invalid | Re-run ./launch-setup.sh to refresh token |
403 Forbidden | Missing Apple Music subscription or regional restriction | Verify subscription is active in Settings; check region availability |
404 Not Found | Song/playlist/ID doesn't exist or is unavailable | Verify ID is correct; check if content is available in your region |
HTTP server verification failed | Setup page won't load | Restart setup.sh; try different browser (Chrome recommended) |
config.json (keep secure)