home / skills / plurigrid / asi / spotify

spotify skill

/skills/spotify

This skill lets you control Spotify playback and manage playlists, search catalog, and view what's playing, boosting your listening efficiency.

npx playbooks add skill plurigrid/asi --skill spotify

Review the files below or copy the command above to add this skill to your agents.

Files (1)
SKILL.md
3.6 KB
---
name: spotify
description: Control Spotify playback and manage playlists. Play music, pause, skip tracks, search for songs/albums/artists, create playlists, add tracks, check what's playing, and manage your library. Requires Spotify Premium.
version: 1.0.0
---


# Spotify Control

Control Spotify playback and manage playlists via MCP.

## When to Use

- Play specific songs, albums, artists, or playlists
- Control playback (pause, skip, previous)
- Search Spotify catalog
- Create and manage playlists
- Check what's currently playing
- Add tracks to queue

## Setup

MCP server configured in `~/.mcp.json`:
```json
{
  "spotify": {
    "command": "node",
    "args": ["/Users/alice/Projects/spotify-mcp-server/build/index.js"]
  }
}
```

OAuth config in `/Users/alice/Projects/spotify-mcp-server/spotify-config.json`.

## Available Tools

### Read Operations
| Tool | Description |
|------|-------------|
| `searchSpotify` | Search tracks, albums, artists, playlists |
| `getNowPlaying` | Get currently playing track |
| `getMyPlaylists` | List user's playlists |
| `getPlaylistTracks` | Get tracks in a playlist |
| `getRecentlyPlayed` | Recently played tracks |
| `getUsersSavedTracks` | Liked songs library |

### Playback Control
| Tool | Description |
|------|-------------|
| `playMusic` | Play track/album/artist/playlist |
| `pausePlayback` | Pause current playback |
| `skipToNext` | Skip to next track |
| `skipToPrevious` | Skip to previous track |
| `addToQueue` | Add item to queue |

### Playlist Management
| Tool | Description |
|------|-------------|
| `createPlaylist` | Create new playlist |
| `addTracksToPlaylist` | Add tracks to playlist |

### Album Operations
| Tool | Description |
|------|-------------|
| `getAlbums` | Get album details |
| `getAlbumTracks` | Get tracks from album |
| `saveOrRemoveAlbumForUser` | Save/remove albums |
| `checkUsersSavedAlbums` | Check if albums saved |

## Example Usage

### Play a Song
```
searchSpotify(query="bohemian rhapsody", type="track", limit=5)
playMusic(uri="spotify:track:6rqhFgbbKwnb9MLmUQDhG6")
```

### Check What's Playing
```
getNowPlaying()
```

### Create a Playlist
```
createPlaylist(name="Workout Mix", description="Pump up songs", public=false)
addTracksToPlaylist(playlistId="...", trackUris=["spotify:track:..."])
```

### Add to Queue
```
addToQueue(type="track", id="6rqhFgbbKwnb9MLmUQDhG6")
```

## Notes

- Requires Spotify Premium for playback control
- Run `npm run auth` in spotify-mcp-server to set up OAuth if tokens expired
- Active Spotify device required for playback (phone, desktop app, etc.)



## Scientific Skill Interleaving

This skill connects to the K-Dense-AI/claude-scientific-skills ecosystem:

### Graph Theory
- **networkx** [○] via bicomodule
  - Universal graph hub

### Bibliography References

- `general`: 734 citations in bib.duckdb



## SDF Interleaving

This skill connects to **Software Design for Flexibility** (Hanson & Sussman, 2021):

### Primary Chapter: 6. Layering

**Concepts**: layered data, metadata, provenance, units

### GF(3) Balanced Triad

```
spotify (+) + SDF.Ch6 (+) + [balancer] (+) = 0
```

**Skill Trit**: 1 (PLUS - generation)


### Connection Pattern

Layering adds metadata. This skill tracks provenance or annotations.
## Cat# Integration

This skill maps to **Cat# = Comod(P)** as a bicomodule in the equipment structure:

```
Trit: 0 (ERGODIC)
Home: Prof
Poly Op: ⊗
Kan Role: Adj
Color: #26D826
```

### GF(3) Naturality

The skill participates in triads satisfying:
```
(-1) + (0) + (+1) ≡ 0 (mod 3)
```

This ensures compositional coherence in the Cat# equipment structure.

Overview

This skill controls Spotify playback and manages playlists through a connected MCP server. It lets you play, pause, skip tracks, search the Spotify catalog, create playlists, add tracks, and inspect the currently playing item. Playback features require an active Spotify Premium account and an active device. The skill is designed for fast interactive control of a personal Spotify account.

How this skill works

The skill sends commands to an MCP-hosted Spotify bridge that performs OAuth-authenticated requests to the Spotify Web API. Read tools query the catalog and the user’s library; playback tools send play/pause/skip and queue actions to the active device. Playlist tools create playlists and add tracks by URI. OAuth tokens and an active Spotify device must be configured and available for playback operations.

When to use it

  • Start or control playback on your active Spotify device
  • Search for tracks, albums, artists, or playlists before playing or saving
  • Create themed playlists and populate them with specific tracks
  • Check what’s currently playing or inspect recently played items
  • Add tracks to the playback queue without interrupting the current song

Best practices

  • Ensure Spotify Premium and an active device (phone, desktop) for playback control
  • Keep OAuth tokens refreshed via the server’s auth flow to avoid expired sessions
  • Use track/album/playlist URIs when calling play or add-to-playlist to avoid ambiguous searches
  • Limit search results with a sensible limit parameter to reduce noise
  • Confirm playlist IDs before adding tracks to avoid adding to the wrong list

Example use cases

  • Play a searched track: search for a song, then call playMusic with its URI
  • Build a workout playlist: createPlaylist then addTracksToPlaylist with chosen track URIs
  • Control a listening session: pausePlayback, skipToNext, or skipToPrevious as needed
  • Inspect listening history: getRecentlyPlayed to review recent tracks and curate playlists
  • Add a track to the queue from a search result using addToQueue

FAQ

Do I need Spotify Premium to use this skill?

Yes. Playback control functions require an active Spotify Premium account and an active device.

How do I authenticate if tokens expire?

Run the server’s OAuth refresh/auth flow provided by the MCP Spotify bridge to renew tokens; keep the OAuth config accessible to the bridge.