"List my YouTube playlists."
↳ fym_playlists_list(service=youtube)
CLAUDE DESKTOP
List my YouTube playlists.
Claude · thinking…
↳ fym_playlists_list(service=youtube)
✓ Done
Tool call completed.
YouTube MCP server
Bring your YouTube 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-desktopWrites 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
"Add a video to a YouTube playlist via the agent."
↳ fym_tracks_add(service=youtube)
"Show my YouTube Watch Later list."
↳ fym_library_tracks(service=youtube)
"Search YouTube for live performances of this band."
↳ fym_search_tracks(service=youtube)
"Remove duplicate videos from my YouTube playlists."
↳ fym_playlists_list(service=youtube)↳ fym_tracks_remove
"Reorder my YouTube "Concerts" playlist by upload date."
↳ fym_playlists_get(service=youtube)↳ fym_tracks_reorder
Capability matrix
Read · Search · Write · Follow
Connect YouTube to your AI in three steps
- Install and open Free Your Music on your desktop.
- Connect your YouTube account in Free Your Music and keep the app running.
- Install the MCP server for your AI app below, restart the AI app, and ask it to list your YouTube playlists.
Install your AI host
Install in
npx -y @freeyourmusic/mcp install --host=claude-desktopWrites 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 MCP: questions and answers
What is MCP for YouTube?
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, so you can ask about your playlists in natural language and let the assistant retrieve the details.
How do I connect YouTube to Claude?
Connect your YouTube 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 playlists.
Can I use YouTube 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 account stays in Free Your Music; each AI app needs its own MCP configuration.
What can an AI assistant do with my YouTube playlists?
Ask your assistant to list YouTube 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 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. Ask the assistant to show you its proposed changes before applying them.
Is the YouTube 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 MCP server?
Free Your Music develops and provides this integration independently. It connects your YouTube 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 account?
Yes. The assistant can list connected accounts and select the one you want to use. If you have multiple YouTube accounts connected, specify the account when asking it to read or edit a playlist.
Does this YouTube MCP server provide video transcripts?
The Free Your Music integration focuses on YouTube playlists and music search. Its MCP tool catalog does not include video transcripts, captions, or video downloads. You can use it to organize playlist entries and search for performances.
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.
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 host→Local 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-desktopWrites to ~/Library/Application Support/Claude/claude_desktop_config.json
Restart Claude Desktop (cmd+Q on macOS). The freeyourmusic tools appear in the integrations sheet.