Lineupify

Lineupify

Say what you want to hear. Get a playlist you can read, edit and trust, in your own account.

lineupify on the web →

Lineupify is an MCP server for Claude Desktop, Claude Code, Cursor and any other MCP host. Paste a festival poster, describe a mood, name an artist or a song you like, point at a playlist, or blend two people's playlists. Lineupify finds the artists, picks their most popular songs, matches them exactly (by ISRC) and builds a draft you can review and edit before anything is published to Spotify. Everything runs on your machine; there is no Lineupify server and no telemetry.

Both need Node.js 20 or newer. Package: lineupify-mcp on npm.

Contents

• Why
• Quick start
• Option A: let your assistant install it
• Option B: guided setup in a terminal
• Option C: one click for Claude Desktop
• No Spotify, or no Premium? Deezer mode
• Spotify without Premium: borrow a friend's app
• What a conversation looks like
• How it works
• Reference — full tables in docs/reference.md
• Privacy, data and terms
• Limits and known issues
• Development
• Credits
• License

Why

Streaming apps are good at playing music and bad at letting you say what you want.

• The daily mixes are not what you are in the mood for. They are built from what you played, not from what you want to play next.
• Shuffle keeps serving the same songs and the same artists. You want new songs by the artists you already love, not the same twenty again.
• You can describe a feeling but cannot find the genre. "Rainy Sunday jazz for cooking" is not a category in any app.
• Adding songs to a playlist takes minutes of searching when it should take one sentence.
• A festival lineup is forty names and you know six. Preparing for it by hand takes an evening.
• Blend only blends profiles. You want to compare two playlists, see what they share and why, and get a mix both people will actually like.
• The algorithm cannot explain itself. You want to see which artist a song came from and why it was picked, then change it.
• Your playlist is on Spotify but your friend is not. You want the list as a file they can use anywhere.

Lineupify answers each of these with a draft you can see, a reason for every track, and a playlist that ends up in your own account.

One sentence and a poster photo in Claude Code: 92 tracks, published private, with the four unmatched acts named instead of silently dropped.

Quick start

Pick one of the three ways to install. All of them end with the same server registered in your host; the Spotify app is the only step nobody can automate, because it is created in your Spotify account.

Option A: let your assistant install it

If your assistant can run terminal commands (Claude Code, Cursor, and similar), paste this into a chat and follow along:

Install the Lineupify MCP server for me and guide me through it. It is the npm package lineupify-mcp (https://www.npmjs.com/package/lineupify-mcp); read its README at https://github.com/SHREESHMAN/lineupify first. Ask me whether I have a Spotify Premium account. If yes, walk me through creating a Spotify app at https://developer.spotify.com/dashboard with the Redirect URI http://127.0.0.1:8765/callback, ask me for the Client ID, then run npx -y lineupify-mcp setup --client-id and npx -y lineupify-mcp auth, and tell me when to approve the login in my browser. If no, skip Spotify: Deezer mode needs nothing. Then run npx -y lineupify-mcp install --claude-code (or --cursor / --claude-desktop, whichever host you are running in), then npx -y lineupify-mcp doctor, show me the result, and tell me what to say next. On Windows run npx through cmd /c.

If Lineupify is already registered but Spotify is not connected (the one-click route, or a hand-written config), paste this instead:

Call Lineupify's status tool. If Spotify is not connected, call connect with my Client ID PASTE_CLIENT_ID_HERE, tell me to approve the login in the browser, then call status again to confirm.

Option B: guided setup in a terminal

1. Create a Spotify app (2 minutes; skip for Deezer mode). Go to https://developer.spotify.com/dashboard, click *Create app*, tick *Web API*, set the Redirect URI to exactly http://127.0.0.1:8765/callback, save, then copy the Client ID from the app's Settings page. No client secret is needed. Full walkthrough with every field: docs/setup-spotify.md.

Screenshots: where "Create app" and the Client ID are

The dashboard. "Create app" is top right.

After saving: the Client ID is the value to copy. The client secret is never needed. The 180-day refresh-token lifetime shown here is why status asks you to reconnect twice a year.

1. Run the guided setup:

   npx -y lineupify-mcp init

It takes the Client ID, logs you in through your browser, adds Lineupify to Claude Desktop, Claude Code or Cursor (whichever it finds), and runs a health check. Every step can be skipped. Restart your host afterwards.

Screenshot: what init looks like

A second run on a machine that is already set up: every step is skippable, and the health check at the end is the same one doctor prints.

1. Ask for a playlist. Any of these work:

• "Make me a playlist for this lineup" *(paste the poster text or attach the image)*
• "Rainy Sunday jazz for cooking, about an hour, nothing explicit"
• "Artists like Khruangbin, two songs each"
• "Songs like Ritviz – Udd Gaye, other artists only"
• "New songs from my favourite artists that I have not liked yet"
• "What does my friend's playlist have in common with mine? Then make us a mix."

Option C: one click for Claude Desktop

Download lineupify- .mcpb from the releases page and double-click it (or drag it onto Claude Desktop). Paste your Client ID into the form, or leave it empty for Deezer mode. Node.js 20 or newer must still be installed. Then say "connect Lineupify to Spotify" in a chat.

Screenshots: the three Claude Desktop screens you will see

Settings → Extensions. Drop the .mcpb file here.

The install dialog. The red warning is Claude Desktop's standard notice for every third-party extension; the code is on GitHub and the package on npm carries a provenance attestation.

After installing: the Client ID field (empty means Deezer mode), the optional Last.fm key, and per-tool permissions. Read-only tools are grouped so you can approve them once.

Other hosts, the config-file route, and running two hosts at once: docs/hosts.md.

No Spotify, or no Premium? Deezer mode

Skip the Spotify app entirely: add Lineupify to your host and ask for a playlist. With no Spotify login, drafts build on Deezer automatically (or say "use Deezer"; the option is provider: "deezer"). Deezer's public API is keyless, so there is nothing to create, paste or approve.

What works in Deezer mode: every seed except your own Spotify taste, every filter, reading, analysing, comparing and merging Deezer playlists and drafts, editing, and all exports. What does not: publishing into an account. Deezer stopped issuing API credentials to new apps in 2025, so no tool can write to a Deezer account today. If Deezer reopens its API, publishing will be added.

Getting a Deezer draft into your Deezer (or Apple Music, YouTube Music) account takes one paste:

1. Ask for the export: "exp