youtube-playlist-mcp
Allows listing videos in public YouTube playlists and retrieving plain-text transcripts for selected videos, with language preference support and inline reporting for videos without captions.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
youtube-playlist-mcp
English · O'zbekcha
Give Claude a whole YouTube playlist to read. A tiny MCP server that lists the videos of any public playlist and fetches their transcripts, so you can ask things like "Summarise every lecture in this course" or "Which video explains closures, and what does it say?"
MCP (Model Context Protocol) is the open standard that lets AI assistants like Claude call external tools and data sources.
Built with FastMCP, yt-dlp and youtube-transcript-api. Runs on your own machine; a Cloudflare Tunnel makes it reachable from claude.ai without opening ports or deploying anything.
Claude (claude.ai / Desktop / Code)
│ HTTPS, Streamable HTTP
▼
Cloudflare Tunnel ──► 127.0.0.1:8000/mcp ──► yt-dlp / youtube-transcript-api ──► YouTube
(playlist_mcp.py)Tools
Tool | Arguments | Returns |
|
| Playlist title, video count, and one line per video: position, ID, title, watch URL. Uses yt-dlp flat extraction, so it is fast and downloads nothing. |
|
| Plain-text transcript for each video, choosing the first available language in the given order. Videos without captions are reported inline instead of failing the whole call. |
The 5-video cap keeps each response small enough for the model's context; Claude simply calls the tool several times for longer playlists.
Related MCP server: mcp-youtube
Install
Requires Python 3.10+.
git clone https://github.com/xoliddev/youtube-playlist-mcp.git
cd youtube-playlist-mcp
python -m venv .venv
.venv\Scripts\activate # macOS/Linux: source .venv/bin/activate
pip install -r requirements.txtRun locally
python playlist_mcp.py
# MCP endpoint: http://127.0.0.1:8000/mcpQuick check with the MCP Inspector:
npx @modelcontextprotocol/inspector
# Transport: Streamable HTTP, URL: http://127.0.0.1:8000/mcpConfiguration
All settings are environment variables; nothing is hard-coded.
Variable | Default | Meaning |
|
| Interface to bind. Keep it local; the tunnel connects to it. |
|
| Port. |
| (empty) | Comma-separated public hostnames accepted in the |
Expose it with Cloudflare Tunnel
Install cloudflared (or drop cloudflared.exe next to the script; it is git-ignored).
Windows, one click: run start_playlist_mcp.cmd. It starts a free quick tunnel, reads its random *.trycloudflare.com hostname from the log, allows exactly that hostname, starts the server and prints the connector URL:
Connector URL: https://random-words-here.trycloudflare.com/mcpManually (any OS):
cloudflared tunnel --url http://127.0.0.1:8000
# copy the https://<name>.trycloudflare.com hostname it prints, then in another terminal:
MCP_ALLOWED_HOSTS=<name>.trycloudflare.com python playlist_mcp.pyQuick tunnels get a new hostname on every start. For a stable URL, create a named tunnel on your own domain and set MCP_ALLOWED_HOSTS=mcp.yourdomain.com (the launcher then skips the quick tunnel and only starts the server).
Connect to Claude
claude.ai or Claude Desktop: Settings → Connectors → Add custom connector, paste https://<your-tunnel-host>/mcp. Enable it in a chat and ask:
Here's a playlist: https://www.youtube.com/playlist?list=... — list the videos, then read the transcripts of the first five and give me a one-paragraph summary of each.
Claude Code (no tunnel needed, same machine):
claude mcp add --transport http youtube-playlist http://127.0.0.1:8000/mcpNotes
The server has no authentication: anyone who knows your tunnel URL can call these two read-only tools while it runs. Quick-tunnel URLs are random and short-lived; for a permanent setup, put the named tunnel behind Cloudflare Access.
Only public playlists and videos with captions (manual or auto-generated) work. YouTube may rate-limit transcript requests from some IPs.
License
MIT © 2026 xoliddev
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Search YouTube videos, read transcripts and get public video information in your AI assistant.
YouTube transcripts, search, channels, playlists and bulk transcript jobs for AI agents. 14 tools.
YouTube transcripts, search, channel/playlist listings and upload tracking for AI agents.
Your YouTube library in Claude, ChatGPT and Cursor: transcripts, breakdowns, summaries, search.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables Claude to search YouTube for artists and manage playlists on your YouTube account.1-
- AlicenseAqualityCmaintenanceEnables conversational YouTube playlist management via Claude, allowing creation, pruning, cleanup, and deletion of playlists through the YouTube Data API v3.5222 npm1MIT
- AlicenseNot gradedqualityCmaintenanceEnables Claude Desktop to fetch full YouTube video transcripts from any URL, so users can summarize, translate, or cite video content without API keys or downloads.MIT
- FlicenseAqualityCmaintenanceEnables Claude Code to retrieve YouTube transcripts, search videos and channels, fetch metadata, playlists, comments, trending videos, engagement analytics, chapters, SponsorBlock-cleaned transcripts, and most-replayed heatmaps.1518 npm-