MCP HubMCP Hub
jkawamoto

mcp-youtube-transcript

by: jkawamoto

MCP server retrieving transcripts of YouTube videos

11created 08/02/2025
Visit
YouTube
transcripts

📌Overview

Purpose: The MCP server allows users to retrieve transcripts for specified YouTube video URLs easily.

Overview: The YouTube Transcript MCP server provides a straightforward tool for fetching video transcripts from YouTube, offering functionality tailored to various environments such as CLI and desktop applications.

Key Features:

  • get_transcript: A core function that retrieves the transcript of a specified YouTube video by requiring the video's URL. Users can optionally specify the desired language for the transcript, defaulting to English if not provided.

  • Compatibility with Various Platforms: Supports integration with different environments such as Goose CLI, Goose Desktop, and Claude Desktop, allowing users to configure and install the server seamlessly based on their preferences.


YouTube Transcript MCP Server

This MCP server retrieves transcripts for given YouTube video URLs.

Tools

get_transcript

Fetches the transcript of a specified YouTube video.

Parameters

  • url (string): The full URL of the YouTube video. This field is required.
  • lang (string, optional): The desired language for the transcript. Defaults to en if not specified.

Installation

For Goose CLI

Edit the configuration file ~/.config/goose/config.yaml to include the following entry:

extensions:
  youtube-transcript:
    name: Youtube Transcript
    cmd: uvx
    args: [--from, git+https://github.com/jkawamoto/mcp-youtube-transcript, mcp-youtube-transcript]
    enabled: true
    type: stdio

For Goose Desktop

Add a new extension with the following settings:

  • Type: Standard IO
  • ID: youtube-transcript
  • Name: Youtube Transcript
  • Description: Retrieve transcripts of YouTube videos
  • Command: uvx --from git+https://github.com/jkawamoto/mcp-youtube-transcript mcp-youtube-transcript

For Claude Desktop

Edit the claude_desktop_config.json file under mcpServers:

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/jkawamoto/mcp-youtube-transcript",
        "mcp-youtube-transcript"
      ]
    }
  }
}

After editing, restart the application.

Installing via Smithery

To install Youtube Transcript for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @jkawamoto/mcp-youtube-transcript --client claude

Using Proxy Servers

In restricted environments, you can use proxy servers.

Set the username and password for the Residential Proxy using:

  • WEBSHARE_PROXY_USERNAME and WEBSHARE_PROXY_PASSWORD
  • --webshare-proxy-username and --webshare-proxy-password

For other proxy servers, set the proxy server URL using:

  • HTTP_PROXY or HTTPS_PROXY
  • --http-proxy or --https-proxy

License

This application is licensed under the MIT License. See the LICENSE file for more details.