Skip to main content
Glama
youtube-transcript-mcp

youtube-transcript-mcp

by yunlinwu

YouTube Transcript MCP Server

An MCP server that gives Claude access to YouTube video transcripts. Extract full transcripts, search for keywords with timestamps, and get direct YouTube links to matching moments.

Tools

get_transcript

Extract the full timestamped transcript from any YouTube video.

Title: Rick Astley - Never Gonna Give You Up (Official Video)
Channel: Rick Astley
Duration: 3:33
Source: captions | Language: en | Segments: 60
---
[0:01] [♪♪♪]
[0:18] ♪ We're no strangers to love ♪
[0:22] ♪ You know the rules and so do I ♪
...

search_transcript

Keyword search across a video's transcript. Matches are grouped, marked with >>>, and include a YouTube link to jump to that moment.

Search: "give you up" in Rick Astley - Never Gonna Give You Up
Matches: 9 hits in 2 group(s)

--- Group 1 (1 hit(s)) — https://www.youtube.com/watch?v=dQw4w9WgXcQ&t=43 ---
     [0:40] ♪ Gotta make you understand ♪
 >>> [0:43] ♪ Never gonna give you up ♪
     [0:45] ♪ Never gonna let you down ♪

Related MCP server: YouTube Ultimate Toolkit MCP

Install

git clone https://github.com/yunlinwu/youtube-transcript-mcp.git
cd youtube-transcript-mcp
pip install -e .

For Whisper fallback (transcribes videos without captions):

pip install -e ".[whisper]"

Setup

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "/path/to/youtube-transcript-mcp/.venv/bin/youtube-transcript-mcp"
    }
  }
}

Claude Code

Add to .claude/settings.json:

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "/path/to/youtube-transcript-mcp/.venv/bin/youtube-transcript-mcp"
    }
  }
}

Then restart Claude Desktop or Claude Code to pick up the server.

How it works

  1. You ask Claude about a YouTube video

  2. Claude calls get_transcript or search_transcript via MCP

  3. The server uses yt-dlp to fetch captions (or Whisper to transcribe audio as a fallback)

  4. Claude gets back a compact, readable transcript and can summarize, search, or analyze it

Requirements

  • Python 3.10+

  • yt-dlp (installed automatically)

  • FFmpeg (only needed for Whisper fallback)

Development

python3 -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
pytest

License

MIT

Available Tools

2 tools
get_transcript_toolA

Get the full transcript of a YouTube video with timestamps.

Args: url: YouTube video URL or video ID lang: Language code for captions (default: "en") use_whisper_fallback: If True, use Whisper when captions unavailable

Inputs: url (required), lang, use_whisper_fallback. Returns: result

search_transcriptB

Search a YouTube video's transcript for matching segments.

Args: url: YouTube video URL or video ID query: Search term to find in the transcript lang: Language code for captions (default: "en") context_seconds: Seconds of context around each match (default: 30)

Inputs: url (required), query (required), lang, context_seconds. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 2 tools

    Disambiguation5/5

    Each tool has a clear, distinct purpose: one fetches the full transcript, the other searches within it. No functional overlap.

    Naming Consistency3/5

    Both use snake_case but the naming pattern is inconsistent: 'get_transcript_tool' includes a redundant '_tool' suffix while 'search_transcript' does not.

    Tool Count5/5

    Two tools are well-scoped for the server's focused purpose of YouTube transcript access and search. No unnecessary tools.

    Completeness4/5

    The tool surface covers the core operations (full transcript retrieval and search) but lacks auxiliary features like language detection or transcript availability checking.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that allows Claude and other AI assistants to interact with the YouTube API, providing tools to search videos/channels and retrieve detailed information about them.
      18 npm
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      A comprehensive MCP server that provides Claude AI with full access to YouTube content, including searchable transcripts, metadata, comments, and playlists. It uniquely supports capturing video screenshots and extracting audio clips for analysis across both local and remote platforms.
      5
      23 npm
      3
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server that extracts YouTube video transcripts (including metadata) as Markdown, enabling AI to summarize and discuss video content without watching it.
      MIT