YouTube Music MCP server

Bring your YouTube Music playlists into the conversation. Connect through Free Your Music and explore your music with Claude, Cursor, Cline, or Claude Code.

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

Writes to ~/Library/Application Support/Claude/claude_desktop_config.json
Restart Claude Desktop (cmd+Q on macOS). The freeyourmusic tools appear in the integrations sheet.

What to ask on YouTube Music

Try

"Export my YouTube Music playlist titles to markdown."

fym_playlists_list(service=youtube-music)
Try

"Find tracks in my YouTube Music library that aren't in my Spotify likes."

fym_library_tracks(service=youtube-music)fym_library_tracks(service=spotify)
Try

"Build a workout playlist on YouTube Music from my liked songs."

fym_library_tracks(service=youtube-music)fym_playlists_createfym_tracks_add
Try

"Unfollow YouTube Music artists with no tracks in my library."

fym_library_artists(service=youtube-music)fym_library_tracks(service=youtube-music)fym_unfollow_artist
Try

"Show my recently-played YouTube Music tracks."

fym_history_recent(service=youtube-music)
Try

"Add my Spotify Liked Songs to a new YouTube Music playlist."

fym_library_tracks(service=spotify)fym_playlists_create(service=youtube-music)fym_tracks_add

Capability matrix

Read · Search · Write · Follow

Connect YouTube Music to your AI in three steps

  1. Install and open Free Your Music on your desktop.
  2. Connect your YouTube Music account in Free Your Music and keep the app running.
  3. Install the MCP server for your AI app below, restart the AI app, and ask it to list your YouTube Music playlists.

Install your AI host

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

Writes to ~/Library/Application Support/Claude/claude_desktop_config.json
Restart Claude Desktop (cmd+Q on macOS). The freeyourmusic tools appear in the integrations sheet.

Works on these too

Explore the Free Your Music MCP server and tool catalog

Free vs Pro

Free

Read playlists, library, history. 100 searches per day across all services.

Pro

Create, rename, delete playlists. Add, remove, reorder tracks. Like, follow artists. Unlimited search.

YouTube Music MCP: questions and answers

What is MCP for YouTube Music?

MCP stands for Model Context Protocol. It lets an AI assistant call tools that work with your connected accounts. Free Your Music provides a local MCP server for YouTube Music, so you can ask about your playlists in natural language and let the assistant retrieve the details.

How do I connect YouTube Music to Claude?

Connect your YouTube Music account in the Free Your Music desktop app, then install @freeyourmusic/mcp for Claude Desktop or Claude Code. Keep Free Your Music open while using the integration. Start by asking Claude to list your connected services and your YouTube Music playlists.

Can I use YouTube Music MCP with Cursor or Cline?

Yes. The same music MCP server works with Cursor and Cline. Choose your AI app in the installer above to copy its setup command. Your connected YouTube Music account stays in Free Your Music; each AI app needs its own MCP configuration.

What can an AI assistant do with my YouTube Music playlists?

Ask your assistant to list YouTube Music playlists, inspect a playlist, or retrieve its tracks. Use the results to compare track lists or turn playlist details into a table. Available operations depend on the service capabilities and the account you connect.

You can also search YouTube Music for music by artist or title without switching away from your AI assistant.

With Pro, use supported playlist tools to create playlists and add or remove tracks on YouTube Music. Ask the assistant to show you its proposed changes before applying them.

Is the YouTube Music MCP integration free?

Free Your Music includes a free MCP tier for reading and up to 100 searches per day across services that support search. Pro unlocks supported write operations and unlimited search. Your music service and AI app may have their own subscription requirements.

Is this an official YouTube Music MCP server?

Free Your Music develops and provides this integration independently. It connects your YouTube Music account through the Free Your Music desktop app. Install the @freeyourmusic/mcp package shown in this guide to use this integration.

Does this MCP server run locally or use a remote URL?

It runs locally using Node.js and communicates with your AI app over stdio. The desktop app must be running on the same computer. Use the install command rather than pasting a hosted MCP server URL. Tool results are returned to your AI app, whose data handling depends on the app and model provider.

Can I connect more than one YouTube Music account?

Yes. The assistant can list connected accounts and select the one you want to use. If you have multiple YouTube Music accounts connected, specify the account when asking it to read or edit a playlist.

Are YouTube MCP and YouTube Music MCP the same integration?

One Free Your Music MCP server supports both, with separate service connections. Choose YouTube for video playlists or YouTube Music for your music library and playlists. Ask your assistant which account is connected before starting.

Explore YouTube MCP

Step-by-step MCP setup guides

Privacy

The MCP server connects to Free Your Music through a local bridge on your computer. Tool results go to your AI app; how that app processes them depends on its settings and model provider.

Your AI hostLocal bridge (127.0.0.1)FYM desktop

Plug in your music.

One command for your AI host. Restart. Done.

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

Writes to ~/Library/Application Support/Claude/claude_desktop_config.json
Restart Claude Desktop (cmd+Q on macOS). The freeyourmusic tools appear in the integrations sheet.