YouTube, inside your AI assistant.

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

Try

"List my YouTube playlists with the number of videos in each."

↳ fym_library_playlists
Try

"Move my YouTube music playlists to YouTube Music."

↳ fym_accounts_list↳ fym_transfers_create
Try

"Remove the duplicate videos from my YouTube playlist Mix."

↳ fym_playlists_preview(tool=dedupe)↳ fym_playlists_apply_tool
Try

"Search YouTube for official live versions of Nirvana songs."

↳ fym_search

What works on {serviceName}

Read · Search · Edit playlists

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

What does the YouTube MCP server do?

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

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

What can my assistant do with YouTube?

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

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

Is the YouTube MCP server free?

No. The YouTube 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 server?

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

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

Can it read video transcripts?

No. It works with your YouTube playlists and searches YouTube. It reads no transcripts or captions and downloads no videos.

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 Music 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 →