@kimtaeyoon83/mcp-server-youtube-transcript

This is an MCP server that allows you to directly download transcripts of YouTube videos.

mediamedia
⭐ 603 stars🍴 101 forks📦 v0.1.1📄 MIT

🔌 Transport

Standard I/O

📦 Installation

Docker

Claude Desktop Configuration

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "-kimtaeyoon83-mcp-server-youtube-transcript": {
      "args": [
        "index.js"
      ],
      "command": "node"
    }
  }
}

🛠️ Available Tools (14)

Detailed

metadata in responses

strip_ads

(boolean, optional, default: true): Filter out sponsorships, ads, and promotional content from transcript based on chapter markers

Optional

timestamps for referencing specific moments

Support

for multiple video URL formats (including YouTube Shorts)

Inputs

- `url` (string, required): A publicly reachable **direct video URL** (e.g. an `.mp4`/`.mov`/`.webm` link or a pre-signed URL). TwelveLabs fetches the file server-side, so a YouTube watch page URL will not work — it serves HTML, not a raw video stream.

include_timestamps

(boolean, optional, default: false): Include timestamps in output (e.g., '[0:05] text')

Zero

external dependencies for transcript fetching

Extract

transcripts from YouTube videos

lang

(string, optional, default: "en"): Language code for transcript (e.g., 'ko', 'en'). Automatically falls back to available languages if requested language is not found.

Analyze

a video with [TwelveLabs](https://twelvelabs.io) Pegasus, a video-understanding model. Unlike `get_transcript`, this reasons over what is *shown* on screen, so it produces useful summaries and answers even for videos with little or no speech (demos, gameplay, b-roll, music videos).

max_tokens

(number, optional, default: 2048): Maximum response length in tokens.

prompt

(string, optional): Instruction or question for the model (e.g. `"Summarize this video in 3 sentences"` or `"What products are shown?"`). Defaults to a general summary.

model

(string, optional, default: `"pegasus1.2"`): Pegasus model to use (`"pegasus1.2"` or `"pegasus1.5"`).

Requires

the `TWELVELABS_API_KEY` environment variable. The transcript tool works without it; analysis is fully opt-in. Grab a free key at [twelvelabs.io](https://twelvelabs.io) — there's a generous free tier.

Capabilities

14
Tools
0
Resources
0
Prompts