Skip to main content
Glama
YouTube Transcript MCP Server

YouTube Transcript MCP Server

by arrrggghhh

YouTube Transcript MCP Server

A Model Context Protocol (MCP) server that provides YouTube transcript fetching functionality. This server allows AI assistants to retrieve transcripts from YouTube videos.

Features

  • Fetch transcripts from YouTube videos using video ID

  • Support for multiple languages with configurable preferences

  • Simple MCP tool interface for easy integration

Related MCP server: Personal MCP Server

Installation

Prerequisites

  • Python 3.8 or higher

  • uv package manager (recommended) or pip

# Clone the repository
git clone https://github.com/arrrggghhh/youtube-transcript-mcp.git
cd youtube-transcript-mcp

# Install dependencies
uv sync

Configuration

Environment Variables

  • YOUTUBE_TRANSCRIPT_FETCHER_LANGS: Comma-separated list of language codes for transcript preferences (default: "ko,en")

    • Example: YOUTUBE_TRANSCRIPT_FETCHER_LANGS=en,es,fr,de

    • The server will attempt to fetch transcripts in the order specified

Adding to Claude Desktop

To use this MCP server with Claude Desktop, you need to add it to your configuration:

1. Locate your Claude Desktop configuration file

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

  • Linux: ~/.config/Claude/claude_desktop_config.json

2. Edit the configuration file

Add the YouTube Transcript MCP server to the mcpServers section:

{
  "mcpServers": {
    "youtube-transcript-mcp": {
        "command": "/path/to/uv",
        "args": [
            "run",
            "--directory",
            "/path/to/cloned/directory",
            "--with",
            "mcp[cli]",
            "--with",
            "youtube_transcript_api",
            "mcp",
            "run",
            "/path/to/youtube-transcript-mcp.py"
        ]
    }
  }
}

Important: Replace /path/to/uv with the actual path to your uv executable, and /path/to/youtube-transcript-mcp.py with the actual path to the youtube-transcript-mcp.py file in your cloned repository.

3. Restart Claude Desktop

After saving the configuration file, restart Claude Desktop for the changes to take effect.

Usage

Once the MCP server is added, you can use it in Claude Desktop by asking Claude to analyze YouTube videos:

"Summarize the YouTube video dQw4w9WgXcQ"
"What are the key points from https://www.youtube.com/watch?v=dQw4w9WgXcQ"
"Give me a brief overview of the content in video ID dQw4w9WgXcQ"

The server will automatically extract the video ID, fetch the transcript in the configured languages, and Claude will analyze and summarize the content.

Development

Project Structure

youtube-transcript-mcp/
├── youtube-transcript-mcp.py  # Main MCP server
├── transcript_fetcher.py      # Core transcript fetching logic
├── pyproject.toml            # Project configuration
├── uv.lock                   # Dependency lock file
└── README.md                 # This file

Available Tools

1 tool
get_transcriptD

Inputs: video_id (required). Returns: result

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    D1.7/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only one tool, there is no possibility of ambiguity or overlap between tools. The tool's purpose is clearly defined as retrieving transcripts, leaving no room for misselection.

    Naming Consistency5/5

    The single tool name follows a clear verb_noun pattern (get_transcript), and since there is only one tool, consistency is inherently perfect with no deviations to assess.

    Tool Count2/5

    A single tool is too few for a server focused on YouTube transcripts, as it lacks essential operations like searching, listing, or managing transcripts. This minimal scope will likely cause agent failures due to incomplete functionality.

    Completeness1/5

    The tool set is severely incomplete for the domain of YouTube transcripts. It only provides retrieval (get_transcript) with no support for operations like search, list, update, or delete, creating significant gaps that will hinder agent workflows.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers