youtube-transcript-mcp
Extract full transcripts from YouTube videos and search for keywords with timestamps.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@youtube-transcript-mcp get the transcript of https://youtu.be/dQw4w9WgXcQ"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
YouTube Transcript MCP Server
An MCP server that gives Claude access to YouTube video transcripts. Extract full transcripts, search for keywords with timestamps, and get direct YouTube links to matching moments.
Tools
get_transcript
Extract the full timestamped transcript from any YouTube video.
Title: Rick Astley - Never Gonna Give You Up (Official Video)
Channel: Rick Astley
Duration: 3:33
Source: captions | Language: en | Segments: 60
---
[0:01] [♪♪♪]
[0:18] ♪ We're no strangers to love ♪
[0:22] ♪ You know the rules and so do I ♪
...search_transcript
Keyword search across a video's transcript. Matches are grouped, marked with >>>, and include a YouTube link to jump to that moment.
Search: "give you up" in Rick Astley - Never Gonna Give You Up
Matches: 9 hits in 2 group(s)
--- Group 1 (1 hit(s)) — https://www.youtube.com/watch?v=dQw4w9WgXcQ&t=43 ---
[0:40] ♪ Gotta make you understand ♪
>>> [0:43] ♪ Never gonna give you up ♪
[0:45] ♪ Never gonna let you down ♪Related MCP server: YouTube Ultimate Toolkit MCP
Install
git clone https://github.com/yunlinwu/youtube-transcript-mcp.git
cd youtube-transcript-mcp
pip install -e .For Whisper fallback (transcribes videos without captions):
pip install -e ".[whisper]"Setup
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"youtube-transcript": {
"command": "/path/to/youtube-transcript-mcp/.venv/bin/youtube-transcript-mcp"
}
}
}Claude Code
Add to .claude/settings.json:
{
"mcpServers": {
"youtube-transcript": {
"command": "/path/to/youtube-transcript-mcp/.venv/bin/youtube-transcript-mcp"
}
}
}Then restart Claude Desktop or Claude Code to pick up the server.
How it works
You ask Claude about a YouTube video
Claude calls
get_transcriptorsearch_transcriptvia MCPThe server uses yt-dlp to fetch captions (or Whisper to transcribe audio as a fallback)
Claude gets back a compact, readable transcript and can summarize, search, or analyze it
Requirements
Development
python3 -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
pytestLicense
MIT
Available Tools
2 toolsget_transcript_toolA
Get the full transcript of a YouTube video with timestamps.
Args: url: YouTube video URL or video ID lang: Language code for captions (default: "en") use_whisper_fallback: If True, use Whisper when captions unavailable
Inputs: url (required), lang, use_whisper_fallback. Returns: result
search_transcriptB
Search a YouTube video's transcript for matching segments.
Args: url: YouTube video URL or video ID query: Search term to find in the transcript lang: Language code for captions (default: "en") context_seconds: Seconds of context around each match (default: 30)
Inputs: url (required), query (required), lang, context_seconds. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
Each tool has a clear, distinct purpose: one fetches the full transcript, the other searches within it. No functional overlap.
Both use snake_case but the naming pattern is inconsistent: 'get_transcript_tool' includes a redundant '_tool' suffix while 'search_transcript' does not.
Two tools are well-scoped for the server's focused purpose of YouTube transcript access and search. No unnecessary tools.
The tool surface covers the core operations (full transcript retrieval and search) but lacks auxiliary features like language detection or transcript availability checking.
Maintenance
Related MCP Connectors
Your YouTube library, in the AI tools you already use: Claude, ChatGPT, Cursor, any MCP client.
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.
Hosted YouTube MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
MCP server for RiverScript, an AI transcription platform - fetches transcripts shared via a link.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server that allows Claude and other AI assistants to interact with the YouTube API, providing tools to search videos/channels and retrieve detailed information about them.18 npm1MIT
- AlicenseAqualityCmaintenanceA comprehensive MCP server that provides Claude AI with full access to YouTube content, including searchable transcripts, metadata, comments, and playlists. It uniquely supports capturing video screenshots and extracting audio clips for analysis across both local and remote platforms.523 npm3MIT
- FlicenseNot gradedqualityDmaintenanceThis MCP server fetches and extracts transcripts from YouTube videos, enabling AI language models to access and analyze video content.1-
- AlicenseNot gradedqualityDmaintenanceMCP server that extracts YouTube video transcripts (including metadata) as Markdown, enabling AI to summarize and discuss video content without watching it.MIT