Spotify, inside your AI assistant.

Connect Spotify to your Free Your Music account once. Then ask Claude, Cursor, Cline or Claude Code to read your playlists, move them to another service and keep them in sync.

Install in
npx -y @freeyourmusic/mcp install --host=claude-desktop

Writes to ~/Library/Application Support/Claude/claude_desktop_config.json
Quit Claude Desktop fully (cmd+Q on macOS) and open it again. The tools show up under the freeyourmusic server.

Ask about your Spotify music

Try

"Copy my Spotify liked songs to Apple Music."

↳ fym_accounts_list↳ fym_transfers_create
Try

"Remove the duplicate songs from my Spotify playlist Throwbacks."

↳ fym_library_playlists↳ fym_playlists_preview(tool=dedupe)↳ fym_playlists_apply_tool
Try

"Sort my Spotify playlist Gym by energy, highest first."

↳ fym_playlists_preview(tool=sort)↳ fym_playlists_apply_tool
Try

"Keep my Spotify playlist Road Trip in sync with Tidal every day."

↳ fym_transfers_create↳ fym_transfers_set_sync
Try

"What did I listen to most on Spotify this month?"

↳ fym_stats_section_get

What works on {serviceName}

Read · Search · Edit playlists

With Pro, the assistant can edit your Spotify playlists. What it can change depends on Spotify and on the playlist: nobody can edit a playlist that somebody else made. The assistant reads what each playlist allows before it acts.

Set up Spotify in three steps

  1. Install the MCP server in your AI app with the command below, then restart the app.
  2. Ask your assistant to sign you in to Free Your Music, and approve the code in your browser.
  3. Ask it to connect Spotify, and sign in to Spotify in the browser tab that opens.

Install it in your AI app

Install in
npx -y @freeyourmusic/mcp install --host=claude-desktop

Writes to ~/Library/Application Support/Claude/claude_desktop_config.json
Quit Claude Desktop fully (cmd+Q on macOS) and open it again. The tools show up under the freeyourmusic server.

More services, same server

See every tool of the Free Your Music MCP server

Free and Pro

Free

In the Free Your Music web app and the mobile apps: connect your services, move playlists, liked songs, albums and artists up to 10,000 songs in total, pick replacements for songs that did not match, use Stats and export the songs that did not move.

Pro

The MCP server and the CLI. Keep transfers in sync. Edit, sort, shuffle, dedupe, split, merge and restore playlists. Playlist insights.

Spotify MCP: common questions

What does the Spotify MCP server do?

It lets an AI assistant use your Spotify account through Free Your Music. MCP (Model Context Protocol) is the way apps like Claude and Cursor call outside tools. You ask in plain words, and the assistant picks the Free Your Music tools it needs.

How do I connect Spotify to Claude?

Run npx -y @freeyourmusic/mcp install --host=claude-desktop (or --host=claude-code) and restart Claude. Ask Claude to sign you in to Free Your Music and approve the code in your browser. Then ask it to connect Spotify.

Does it work with Cursor and Cline too?

Yes. One server works in Claude Desktop, Claude Code, Cursor and Cline. Install it once per app. They all share one Free Your Music sign-in on your computer, and your Spotify connection lives in your Free Your Music account, so you connect Spotify only once.

What can my assistant do with Spotify?

It can read your Spotify library and move it to or from any other service you connected. It can start a transfer, follow its progress, turn on auto-sync and list the songs that did not match.

It can search the Spotify catalogue, for example to find the right version of a song that did not match.

With Pro, it can edit your Spotify playlists: add and remove songs, sort, shuffle, remove duplicates, split, merge and go back to an earlier version, where Spotify allows it.

Is the Spotify MCP server free?

No. The Spotify MCP server is part of Free Your Music Pro, together with the CLI, auto-sync, the playlist tools and playlist insights. Transfers in the Free Your Music web app and the mobile apps stay free up to 10,000 songs in total.

Is this an official Spotify server?

No. Free Your Music builds it independently. It reaches Spotify through the account you connect to Free Your Music. To use it, install the @freeyourmusic/mcp package shown on this page.

Where does the server run?

On your computer, with Node.js. Your AI app starts it and talks to it over stdio, and it calls the Free Your Music API over HTTPS. You do not paste a server URL.

Can I connect two Spotify accounts?

Yes. Each connected account has its own id. Tell the assistant which Spotify account you mean, for example by its name, and it picks the right one from your account list.

Can Claude move my Spotify playlists to Apple Music?

Yes. Name the playlists, and Claude starts a transfer, follows its progress and lists the songs it could not match, so you can pick a replacement. Pro has no song limit.

Setup guides per AI app

Privacy

The CLI and the MCP server run on your computer. They call the Free Your Music API over HTTPS with your account session, which sits in ~/.fym/credentials.json and only your user can read. Your music service logins stay encrypted on Free Your Music servers and never reach your AI app. Tool results do go to your AI app, and what it does with them depends on its settings and its model provider.

Your AI app or terminal→Free Your Music API (HTTPS)→Your music services

Give your assistant the keys to your music.

Copy one command, restart your AI app and ask it to sign you in.

Install in
npx -y @freeyourmusic/mcp install --host=claude-desktop

Writes to ~/Library/Application Support/Claude/claude_desktop_config.json
Quit Claude Desktop fully (cmd+Q on macOS) and open it again. The tools show up under the freeyourmusic server.