mcpField
Y
yt-dlp-mcp

yt-dlp-mcp

Local
github.com/gavinHuangSocial Media0Updated 71w ago
Repository

About yt-dlp-mcp

yt-dlp-mcp is an MCP server for YouTube video search, channel listings, and transcript extraction. It is intended for MCP clients that need these operations through yt-dlp.

Key features

  1. 01Extract video transcripts
  2. 02Preserve transcript timestamps optionally
  3. 03Search YouTube videos
  4. 04List recent channel videos

Use cases

  1. 01Retrieve a video's transcript
  2. 02Find videos by search terms
  3. 03Review recent uploads from a channel

MCP support

Exposes transcript extraction, video search, and channel listing as tools for MCP clients.

#yt-dlp#youtube#video-downloader

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "yt-dlp-mcp-gavinhuang": {
      "command": "uvx",
      "args": [
        "yt-dlp-mcp"
      ]
    }
  }
}
Run commanduvx yt-dlp-mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypiyt-dlp-mcp

Tools

3

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
urlstringYesYouTube video URL
keep_timestampsbooleanNoWhether to keep timestamp information in the transcription

Details

From the project README

yt-dlp MCP Server

A Model Context Protocol (MCP) server that provides YouTube video operations using yt-dlp.

Features

  • Get Transcriptions: Extract transcriptions from YouTube videos with optional timestamp preservation
  • Search Videos: Search for YouTube videos by terms and return URLs
  • List Channel Videos: Get recent videos from a YouTube channel

Installation

pip install -e .

Usage

Run the MCP server:

yt-dlp-mcp

Tools

get_transcription
  • Input: YouTube URL, optional timestamp preservation flag
  • Output: Video transcription text
search_videos
  • Input: Search terms
  • Output: List of YouTube video URLs
list_channel_videos
  • Input: Channel name/URL, number of videos to return
  • Output: List of recent video URLs from the channel

Requirements

  • Python 3.8+
  • yt-dlp
  • fastmcp
  • youtube-search-python

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.