# MCP Youtube Transcript

> MCP Youtube Transcript is an open-source MCP server for design and media. Fetch YouTube transcripts, timed segments, languages and video info for LLMs. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/jkawamoto/mcp-youtube-transcript
- **MCP Registry name:** io.github.jkawamoto/mcp-youtube-transcript
- **Categories:** [design and media](https://ai-powered.com/categories/design-and-media), [web search and scraping](https://ai-powered.com/categories/web-search-and-scraping), [news and media](https://ai-powered.com/categories/news-and-media)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-youtube-transcript -- npx -y https://github.com/jkawamoto/mcp-youtube-transcript/releases/download/v0.8.4/mcp-youtube-transcript.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```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"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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"
      ]
    }
  }
}
```

## Tools

- `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

## 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.

## Alternatives

- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [TrendRadar](https://ai-powered.com/mcp/trendradar): TrendRadar is an open-source MCP server for communication.
- [next-ai-draw-io](https://ai-powered.com/mcp/next-ai-draw-io-2): next-ai-draw-io is an open-source MCP server for ai models and llm tooling.
- [mcp-for-blender](https://ai-powered.com/mcp/mcp-for-blender): mcp-for-blender is an open-source MCP server for design and media.
- [Firecrawl MCP Server](https://ai-powered.com/mcp/firecrawl-mcp-server): Firecrawl MCP Server is a freemium MCP server for web search and scraping.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Douyin_TikTok_Download_API](https://ai-powered.com/mcp/douyin-tiktok-download-api): Douyin_TikTok_Download_API is an open-source MCP server for web search and scraping.

---
Source: https://ai-powered.com/mcp/mcp-youtube-transcript
