YouTube Music, inside your AI assistant.

Connect YouTube Music 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 YouTube Music music

Try

"Move my YouTube Music playlists to Spotify."

↳ fym_library_playlists↳ fym_transfers_create
Try

"Remove the duplicate songs from my YouTube Music playlist Chill."

↳ fym_playlists_preview(tool=dedupe)↳ fym_playlists_apply_tool
Try

"Show me the songs I liked on YouTube Music."

↳ fym_library_collections↳ fym_library_tracks
Try

"Merge my two workout playlists on YouTube Music into one."

↳ fym_library_playlists↳ fym_playlists_merge

What works on {serviceName}

Read · Search · Edit playlists

With Pro, the assistant can edit your YouTube Music playlists. What it can change depends on YouTube Music 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 YouTube Music 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 YouTube Music, and sign in to YouTube Music 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

Spotify MCP
Apple Music MCP
Tidal MCP
Deezer MCP
Amazon Music MCP
Audiomack MCP

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 with no song limit, 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.

YouTube Music MCP: common questions

What does the YouTube Music MCP server do?

It lets an AI assistant use your YouTube Music 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 YouTube Music 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 YouTube Music.

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 YouTube Music connection lives in your Free Your Music account, so you connect YouTube Music only once.

What can my assistant do with YouTube Music?

It can read your YouTube Music 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 YouTube Music catalogue, for example to find the right version of a song that did not match.

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

Is the YouTube Music MCP server free?

No. The YouTube Music 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, with no song limit.

Is this an official YouTube Music server?

No. Free Your Music builds it independently. It reaches YouTube Music 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 YouTube Music accounts?

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

Are YouTube and YouTube Music separate connections?

Yes. Connect YouTube for your video playlists and YouTube Music for your music library. One MCP server handles both, and it can move playlists from one to the other.

Explore YouTube MCP

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.

See every MCP tool →Working in a terminal? Get the CLI →