MCP Youtube Transcript
Fetch YouTube transcripts, timed segments, languages and video info for LLMs
- Pricing
- Open source
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 0.8.4
- Listing updated
- today
Similar MCP servers
About MCP Youtube Transcript
MCP Youtube Transcript is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.
The server wraps YouTube transcript retrieval for agents. Long videos are split into chunks of 50,000 characters by default, and a next_cursor value lets the model fetch the rest, so lectures or podcasts do not overflow the context window. The limit is configurable with --response-limit, and a negative value disables paging.
Because YouTube blocks many automated requests from cloud and data-centre IPs, it supports Webshare residential proxies, ScrapingAnt (which needs a paid subscription) and generic HTTP or HTTPS proxies set through environment variables or flags.
It runs over stdio, usually launched with uvx, and can also be installed as an .mcpb bundle for Claude Desktop or used from a Docker image. The code is MIT licensed.
Install
Run in a terminal
claude mcp add mcp-youtube-transcript -- npx -y https://github.com/jkawamoto/mcp-youtube-transcript/releases/download/v0.8.4/mcp-youtube-transcript.mcpbAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp-youtube-transcript": {
"command": "npx",
"args": [
"-y",
"https://github.com/jkawamoto/mcp-youtube-transcript/releases/download/v0.8.4/mcp-youtube-transcript.mcpb"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-youtube-transcript": {
"command": "npx",
"args": [
"-y",
"https://github.com/jkawamoto/mcp-youtube-transcript/releases/download/v0.8.4/mcp-youtube-transcript.mcpb"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp-youtube-transcript": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"https://github.com/jkawamoto/mcp-youtube-transcript/releases/download/v0.8.4/mcp-youtube-transcript.mcpb"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-youtube-transcript": {
"command": "npx",
"args": [
"-y",
"https://github.com/jkawamoto/mcp-youtube-transcript/releases/download/v0.8.4/mcp-youtube-transcript.mcpb"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp-youtube-transcript": {
"command": "npx",
"args": [
"-y",
"https://github.com/jkawamoto/mcp-youtube-transcript/releases/download/v0.8.4/mcp-youtube-transcript.mcpb"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (4)
Taken from the project documentation; the running server may differ.
- get_transcript
- Plain-text transcript for a YouTube URL
- get_timed_transcript
- Transcript segments with start times and durations
- get_available_languages
- List manual and auto-generated languages
- get_video_info
- Video title and channel metadata
What it does
- Plain transcripts
- Get the text of a video by URL with a preferred language.
- Timed transcripts
- Get segments with start times and durations.
- Language listing
- See manual and auto-generated languages available.
- Video metadata
- Read title and channel details.
- Automatic pagination
- Chunks long transcripts with a cursor for the next part.
- Proxy support
- Webshare, ScrapingAnt and standard proxies to avoid IP blocks.
Good for
- Summarise a long lecture video
- Quote a moment using timestamps
- Check which caption languages exist
- Feed podcast transcripts into notes
Pricing
Open source
MIT licensed; ScrapingAnt proxy option needs a paid subscription
More servers for the same service
MCP Youtube Transcript FAQ
How do I install it?
Run it with uvx, import the .mcpb bundle in Claude Desktop, or use the Docker image.
Why would I need a proxy?
The README says YouTube blocks cloud and data-centre IPs.
How are long videos handled?
Transcripts over 50,000 characters are chunked with a next_cursor.
What is the licence?
MIT.
Is MCP Youtube Transcript free?
Yes. MCP Youtube Transcript is open source, so you can use and self-host it for free.
How do I add MCP Youtube Transcript to Claude Code?
Run this command in your terminal: claude mcp add mcp-youtube-transcript -- npx -y https://github.com/jkawamoto/mcp-youtube-transcript/releases/download/v0.8.4/mcp-youtube-transcript.mcpb
What are the best alternatives to MCP Youtube Transcript?
The closest alternatives to MCP Youtube Transcript are Scrapling MCP Server, HyperFrames by HeyGen, TrendRadar, next-ai-draw-io and mcp-for-blender.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.



