Skip to content
MCP server

MCP Youtube Transcript

Fetch YouTube transcripts, timed segments, languages and video info for LLMs

Runs locallyStatus and history
Install
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.mcpb

Add 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"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

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"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers