@kimtaeyoon83/mcp-server-youtube-transcript

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

mediamedia
592 stars🍴 99 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)

Support

for multiple video URL formats (including YouTube Shorts)

strip_ads

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

Extract

transcripts from YouTube videos

Detailed

metadata in responses

Zero

external dependencies for transcript fetching

Optional

timestamps for referencing specific moments

include_timestamps

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

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.

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

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"`).

max_tokens

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

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