youtube-transcript
Fetches a YouTube video's transcript from a video link and returns the captions with start timestamps on every line, enabling an AI assistant to read, summarize, and reference exact moments in the video.
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 Get the transcript of https://youtu.be/1HtydHmdhrQ and summarize the main point"
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
An MCP server that lets an AI assistant read a YouTube video's transcript.
You give the assistant a YouTube link. It calls one tool, get_transcript, and gets the captions back with a start time on every line:
[0:02] tech professionals, and in this video,
[0:04] I'm going to share with you exactly what
[0:06] works, what clients are paying for rightThe timestamps let the assistant (and you) point at the exact moment something was said.
New to MCP? It stands for Model Context Protocol. It is a standard way to give an AI assistant a small program it can call, the way a charger standard lets one cable fit many devices. This server is one such program. It runs on your own computer.
What you need
A computer running macOS, Linux or Windows
uv, a tool that installs Python and the dependencies for youClaude Code or Claude Desktop (any assistant that supports MCP servers over stdio will also work)
Python 3.11 or newer. If you don't have it,
uvwill fetch it.
Related MCP server: YouTube Transcript MCP Server
1. Download it
git clone https://github.com/noelogbuagu/youtube-transcript-mcp.git
cd youtube-transcript-mcp
pwdCopy the folder path that pwd prints. You need it in the next step. On Windows PowerShell, use Get-Location instead.
2. Check that it works
uv run client.pyThe first run downloads the dependencies. You should see a video id, a character count and the first few lines of a transcript. If you do, the server works.
3. Add it to your assistant
Replace /full/path/to/youtube-transcript-mcp with the path you copied.
Claude Code
claude mcp add --transport stdio youtube-transcript -- uv --directory "/full/path/to/youtube-transcript-mcp" run server.pyCheck that it was added:
claude mcp listThen start claude and ask: "Get the transcript of https://www.youtube.com/watch?v=1HtydHmdhrQ and summarise the main point."
Claude Desktop
Open Settings > Developer > Edit Config. This opens
claude_desktop_config.json.Add the server under
mcpServers:
{
"mcpServers": {
"youtube-transcript": {
"command": "uv",
"args": [
"--directory",
"/full/path/to/youtube-transcript-mcp",
"run",
"server.py"
]
}
}
}Quit Claude Desktop completely and open it again. The
get_transcripttool should now appear in the tools list.
If Claude Desktop says it cannot find uv, replace "command": "uv" with the full path to it. Run which uv (macOS and Linux) or where uv (Windows) to get that path. Desktop apps often don't see the same PATH as your terminal.
Cursor and other editors
Any editor that can start an MCP server over stdio works with the same command: uv --directory "/full/path/to/youtube-transcript-mcp" run server.py.
Troubleshooting
Error: Could not retrieve a transcript: the video may have no captions, or captions may be turned off by its owner. Try another video.Works in the terminal, fails after a while or from a cloud machine: YouTube blocks requests that come from many data-centre addresses. Running the server on your own computer is the reliable way. If you do hit blocks, the next section helps.
The tool doesn't show up in Claude Desktop: the config file must be valid JSON (watch for missing commas), and you must fully quit and reopen the app.
Optional: use a proxy
If YouTube blocks your requests, you can route them through a Webshare proxy. Copy .env.example to .env and fill in:
WEBSHARE_USERNAME=
WEBSHARE_PASSWORD=Leave them empty and the server connects directly. .env is ignored by git, so your credentials stay local.
Using it as a thinking partner
A transcript on its own is just text. What helped me was keeping a notebook next to it: a short note of what I'm trying to decide, and one small file per video with what I took from it. The notebook.example/ folder shows the shape: an aim.md, a card template, and a few rules for the assistant to follow in AGENTS.md. Copy it into its own folder and point your assistant at it.
Development
uv run --group dev pytest # offline tests, no network needed
uv run client.py # live smoke test
uv run server.py --transport streamable-http # serve over HTTP on 127.0.0.1:8050
uv run mcp dev server.py # open the MCP InspectorProject layout
youtube-transcript-mcp/
server.py # entrypoint your assistant starts
client.py # smoke test: starts the server and calls the tool
notebook.example/ # optional notes setup
src/youtube_transcript_mcp/
utils.py # video id parsing, [m:ss] formatting
youtube/service.py # fetches captions, optional proxy
mcp/server.py # exposes get_transcript as an MCP tool
tests/Built on the MCP Python SDK 2.3 and youtube-transcript-api.
Not built yet
Saving transcripts so a later chat can search what was already watched.
Hosting the server so it works away from your computer.
License
MIT. See LICENSE.
Available Tools
1 toolget_transcriptB
Get the caption transcript of a YouTube video, one [m:ss]-stamped line per caption.
Inputs: video_url_or_id (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
There is only one tool, so there is no possibility of ambiguity or misselection between tools. Its purpose (fetching a YouTube caption transcript) is unambiguous.
The single tool uses a clear, conventional snake_case verb_noun pattern (get_transcript). With only one name there is no inconsistency to speak of, and the name matches the server's stated purpose.
One tool is thin, but the server is deliberately scoped to a single capability and that tool earns its place. It falls just short of a full 5 because the surface offers no room for even closely related operations.
Core retrieval of a transcript is covered, but obvious adjacent operations are absent: listing available caption languages, selecting a language, or returning video metadata. Multi-language caption handling in particular is a notable gap that could cause agent failures.
Maintenance
Related MCP Connectors
YouTube transcripts for AI agents: captions with timestamps, languages, TXT, SRT and VTT export.
YouTube for AI agents: transcripts, comments, video stats, channel monitor, Shorts captions.
Fetch YouTube transcripts, monitor channels and track keyword matches from your AI assistant.
YouTube transcripts for AI agents: 150+ languages, AI transcription fallback, search, summaries.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables AI assistants to analyze and summarize YouTube videos by extracting captions, subtitles, and comprehensive metadata including title, description, and duration in multiple languages.147 npm62MIT
- FlicenseDqualityDmaintenanceEnables AI assistants to fetch and analyze transcripts from YouTube videos using video IDs or URLs, with support for multiple language preferences.1-
- AlicenseAqualityDmaintenanceEnables AI assistants to fetch YouTube video transcripts with precise timestamps, multi-language support, and time-range filtering.31MIT
- FlicenseAqualityCmaintenanceEnables AI assistants to fetch YouTube video metadata, chapters, and timestamped transcripts (including paginated and language-specific caption retrieval) so they can produce summaries, study notes, comparisons, and source-referenced answers. The returned transcript evidence also carries explicit coverage status, letting the assistant know when a transcript is partial or unavailable.4-