youtube-summarize
The youtube-summarize MCP server enables AI assistants to interact with YouTube videos and playlists:
Fetch transcripts – Get a video's transcript in
text,json,srt,webvtt, orprettyformat, with options for timestamps, metadata, language preference, and HTML formatting.Summarize videos – Retrieve a transcript paired with summarization instructions (custom or default) for an LLM to generate a summary.
Get video metadata – Obtain details like title, description, channel, upload date, duration, views, tags, and chapters.
List playlist videos – Enumerate videos in any public playlist with key details (title, ID, channel, duration, views, URL), with options to limit results and sort by index, title, duration, or views.
List available transcript languages – Discover all transcript languages offered for a given video.
Supports various YouTube URL formats (youtube.com/watch?v=, youtu.be/, youtube.com/shorts/, etc.) or bare video IDs, with multi-language fallback support.
Enables fetching video transcripts in multiple formats, listing available transcript languages, and generating structured content for video summarization.
youtube-summarize
MCP server that fetches YouTube video transcripts and optionally summarizes them.

Features
Fetch transcripts in multiple formats (text, JSON, SRT, WebVTT, pretty-print)
Video metadata — title, description, channel, upload date, duration, views, chapters (via yt-dlp)
Optional timestamps in plain-text transcripts
Summarize videos — returns transcript with the prompt clearly broken out for human review before the LLM acts on it
List playlist videos — fast enumeration of any public playlist with optional sorting
Search videos — clean ranked results with sort and filter options, without the ads, Shorts shelves, and personalized recommendations of the YouTube website
List available languages for any video's transcripts
Flexible URL parsing — accepts full YouTube URLs (
youtube.com/watch?v=,youtu.be/,youtube.com/embed/,youtube.com/shorts/) or bare video IDsMulti-language support — request transcripts in specific languages with fallback priority
Related MCP server: ytt-mcp
Tools
get_transcript
Fetch a YouTube video's transcript. By default the response is prefixed with a [METADATA] block (title, channel, published, duration, views, description); pass include_metadata=false for transcript-only output.
Parameter | Type | Default | Description |
| string | required | YouTube video URL or video ID |
| string[] |
| Preferred languages in priority order |
| string |
| Output format: |
| boolean |
| Keep HTML formatting tags in the transcript |
| boolean |
| When |
| boolean |
| Prepend a |
summarize_transcript
Fetch a transcript and return it with summarization instructions. The response is structured into clearly-labeled sections ([INSTRUCTIONS], [PROMPT_SOURCE], [VIDEO], [METADATA], [TRANSCRIPT]) so a human can review the prompt before letting the LLM act on it.
Parameter | Type | Default | Description |
| string | required | YouTube video URL or video ID |
| string | (default prompt) | Custom summarization instructions |
| string[] |
| Preferred languages in priority order |
| boolean |
| Prefix each transcript line with |
| boolean |
| Include a |
get_video_metadata
Fetch metadata (title, description, channel, upload date, duration, views, tags, chapters, etc.) for a YouTube video. Backed by yt-dlp.
Parameter | Type | Default | Description |
| string | required | YouTube video URL or video ID |
list_playlist_videos
List the videos in a YouTube playlist (title, ID, channel, duration, views, URL). Per-video metadata is intentionally lean so the call stays fast even for large playlists; call get_video_metadata with a specific video ID for full detail.
Parameter | Type | Default | Description |
| string | required | YouTube playlist URL (with |
| integer |
| Maximum videos to return |
| string |
| One of: |
| string |
|
|
search_videos
Search YouTube for videos and return a clean ranked list (title, ID, channel, duration, views, URL) — only actual videos, with no ads, recommendation shelves, or personalization. Relevance ordering still comes from YouTube's backend. Pair with get_transcript or summarize_transcript on a result's ID or URL.
Parameter | Type | Default | Description |
| string | required | Search terms |
| integer |
| Maximum results to return |
| string |
| One of: |
| string |
| Filter by upload time: |
| string |
| Filter by length: |
list_transcripts
List available transcript languages for a video.
Parameter | Type | Default | Description |
| string | required | YouTube video URL or video ID |
Installation
Quick start (recommended)
uvx youtube-summarizeClaude Desktop
Add to your claude_desktop_config.json:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"youtube-summarize": {
"command": "uvx",
"args": ["youtube-summarize"]
}
}
}Claude Code
claude mcp add youtube-summarize -- uvx youtube-summarizeOther MCP clients
Run the server over stdio:
uvx youtube-summarizePrerequisites
Python 3.13+
uv package manager
Development
# Install dependencies
uv sync
# Launch the MCP inspector (web UI for testing tools)
uv run mcp dev main.pyLicense
MIT
mcp-name: io.github.zlatkoc/youtube-summarize
Available Tools
6 toolsget_transcriptA
Fetch a YouTube video's transcript.
Args: url: YouTube video URL or video ID languages: Preferred languages in priority order (e.g. ["en", "de"]). Defaults to English. format: Output format — one of: text, json, pretty, webvtt, srt preserve_formatting: Keep HTML formatting tags in the transcript text include_timestamps: When True with format="text", prefix each line with [HH:MM:SS]. Ignored for json/srt/webvtt/pretty (those formats already include timestamps). include_metadata: When True (default), prepend a [METADATA] block (title, channel, published, duration, views, description) before the transcript. Pass False for transcript-only output.
Inputs: url (required), format, languages, include_metadata, +2 more. Returns: result
get_video_metadataA
Fetch metadata (title, description, channel, upload date, duration, views, chapters, etc.) for a YouTube video.
Args: url: YouTube video URL or video ID
Inputs: url (required). Returns: result
list_playlist_videosA
List the videos in a YouTube playlist (titles, IDs, channels, durations, views).
Per-video metadata is intentionally lean so the call stays fast even for big playlists. For full metadata on a specific video, call get_video_metadata with that video's ID.
Args: url: YouTube playlist URL (with ?list=...) or bare playlist ID limit: Maximum videos to return (default 500). Pass a smaller value to truncate. sort_by: Sort key — "index" (playlist order, default), "title", "duration", "views". "upload_date" is not supported in this fast-mode tool. order: "asc" (default) or "desc".
Inputs: url (required), limit, order, sort_by. Returns: result
list_transcriptsA
List available transcript languages for a YouTube video.
Args: url: YouTube video URL or video ID
Inputs: url (required). Returns: result
search_videosA
Search YouTube for videos and return a clean ranked result list.
Unlike the YouTube website, results contain only actual videos — no ads, recommendation shelves, or personalization. Relevance ordering still comes from YouTube's backend. Pair with get_transcript or summarize_transcript on a result's ID or URL.
Args: query: Search terms limit: Maximum results to return (default 10) sort_by: Result order — "relevance" (default), "date" (newest first), "views", "rating" uploaded: Filter by upload time — "any" (default), "hour", "today", "week", "month", "year" duration: Filter by length — "any" (default), "short" (<4 min), "medium" (4-20 min), "long" (>20 min)
Inputs: query (required), limit, sort_by, duration, +1 more. Returns: result
summarize_transcriptA
Fetch a YouTube video's transcript and return it with summarization instructions.
The LLM client should use the returned instructions and transcript to produce a summary. The output is structured into clearly-labeled sections so a human can review the prompt before letting the LLM act on it.
Args: url: YouTube video URL or video ID prompt: Custom summarization instructions. If omitted, a default summary prompt is used. languages: Preferred languages in priority order (e.g. ["en", "de"]). Defaults to English. include_timestamps: When True, prefix each transcript line with [HH:MM:SS]. include_metadata: When True (default), include a [VIDEO] block with title, channel, published date, duration, views, and description.
Inputs: url (required), prompt, languages, include_metadata, +1 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool targets a clear and distinct aspect: listing transcript languages, fetching transcripts, summarizing with instructions, fetching metadata, listing playlist videos, and searching. Overlap between get_transcript and summarize_transcript is clarified by the latter's added summarization step, and descriptions make the difference explicit.
All tool names follow a consistent verb_noun pattern with lowercase snake_case (e.g., list_transcripts, get_transcript, summarize_transcript). The naming is predictable and intuitive.
Six tools cover the core functionality of a YouTube summarization service (transcript retrieval, summarization, metadata, search, playlist listing) without unnecessary redundancy. The scope is well-balanced.
The tool surface provides end-to-end coverage: listing available transcripts, fetching them in multiple formats, summarizing with custom prompts, retrieving video metadata, searching videos, and listing playlist contents. No obvious gaps for the stated purpose.
Maintenance
Related MCP Connectors
An MCP server that gives any LLM or agent clean YouTube transcripts on demand: a single video, a whole channel, or a playlist, plus AI cleanup of auto-generated captions. API-key auth, credit-based, same backend as the public v1 API. Get a free API key with 25 free credits at youtubetranscriptdownload.com/account.
Real-time YouTube transcripts, comments, channels & video search MCP. Local npx or hosted OAuth.
MCP server for RiverScript, an AI transcription platform - fetches transcripts shared via a link.
Fetch the transcript of any YouTube video (plain text or timestamped segments, in any available caption language), search YouTube for videos and channels, list a channel's uploads, Shorts, playlists and community posts, search inside one channel, and list every video in a playlist. Hosted Streamable HTTP server from getyoutubetranscript.com; sign in with OAuth or an API key. Credit-based: one credit per successful call.
Related MCP Servers
- AlicenseBqualityBmaintenanceAn MCP server that enables the extraction of transcripts and detailed metadata from YouTube videos. It allows users to retrieve video information like titles and descriptions, as well as transcripts with optional timestamps and language selection.2MIT
- AlicenseBqualityDmaintenanceAn MCP server designed to fetch transcripts for YouTube videos. It enables AI tools to access video text content for tasks like summarization, analysis, and key takeaway extraction.174MIT
- FlicenseBqualityDmaintenanceAn MCP server that extracts transcripts, metadata, and summaries from YouTube videos across various URL formats including Shorts and standard links. It provides comprehensive video data and insights for analysis within MCP-compatible environments.3-
- AlicenseNot gradedqualityDmaintenanceMCP server for fetching YouTube video transcripts without an API key.GPL 3.0