Playlistable MCP for Openclaw

An AI-powered Spotify playlist generator and music discovery tool using the Model Context Protocol.

brackyt
v1.0.0
Feb 28, 2026
1
951
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install playlistable

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install playlistable using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Playlistable MCP?

Playlistable MCP is a specialized tool designed to bridge the gap between AI agents and your Spotify library. By leveraging these Openclaw Skills, users can transform simple natural language prompts like "chill lo-fi for studying" into fully realized Spotify playlists in seconds. The skill provides a robust interface for searching tracks, managing existing playlists, and receiving personalized music recommendations based on the time of day and listening habits.

Built on a streamlined HTTP transport, this integration allows for asynchronous playlist creation where the user receives a Spotify URL immediately while the AI populates the tracks in the background. Whether you are building a personal music assistant or looking to automate your discovery workflow, these Openclaw Skills offer the necessary tools to handle OAuth authentication, music metadata retrieval, and playlist CRUD operations seamlessly.

Playlistable MCP Use Cases

  • Generate a Spotify playlist instantly from a specific mood or activity prompt.
  • Receive AI-curated playlist suggestions based on the current time of day.
  • Search for specific tracks and artists to build or edit playlists programmatically.
  • Automate the management of Spotify libraries using Openclaw Skills.
  • Integrate music discovery into a broader AI agent workflow or coding environment.

How Playlistable MCP Works

  1. Authenticate with Spotify via a local OAuth flow to obtain a secure API key.
  2. Send a natural language prompt to the generate_playlist tool to initiate the AI creation process.
  3. Receive a Spotify playlist URL immediately for instant access.
  4. Poll the playlist status periodically as the AI populates the tracks in the background.
  5. Utilize search and edit tools to fine-tune the resulting playlist or manage existing library content.

Playlistable MCP Setup

To get started with these Openclaw Skills, you first need to authenticate your Spotify account:

node scripts/auth.mjs

This script launches a local server to handle OAuth and saves your credentials to config/auth.json. You can also manually set the PLAYLISTABLE_API_KEY environment variable. Once authenticated, you can list available tools or call them directly:

node scripts/mcp-call.mjs --list-tools

Playlistable MCP Data Schema & Taxonomy

The skill organizes data primarily through Spotify IDs and JSON-RPC responses. Key data structures include:

Component Description
Auth Config Stored in config/auth.json containing the API key.
Playlist ID Unique Spotify identifier used for all management operations.
Track ID Standard Spotify track URI (e.g., 4iV5W9uYEdYUVa79Axb7Rh).
Tool Params JSON-formatted objects specifying moods, limits, or user time.

Playlistable MCP Advanced Features

  • Time-aware suggestions using the userHour parameter for context-specific music.
  • Automatic polling support via the --wait flag to handle asynchronous playlist generation.
  • Multi-tier support for both free teaser playlists and full playlists for paid users.
  • Direct search capabilities for tracks and artists to bypass prompt-based generation when specific IDs are known.
  • Streamable HTTP transport implementation for efficient tool communication within Openclaw Skills.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*