Home / MCP / yt-dlp-mcp MCP Server

yt-dlp-mcp MCP Server

Provides YouTube and platform video search, metadata, subtitles, transcripts, and downloads through MCP-enabled agents.

typescript

157stars

View on GitHub

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
    "mcpServers": {
        "yt_dlp": {
            "command": "npx",
            "args": [
                "-y",
                "@kevinwatt/yt-dlp-mcp"
            ],
            "env": {
                "YTDLP_DOWNLOADS_DIR": "/path/to/downloads",
                "YTDLP_DEFAULT_RESOLUTION": "1080p",
                "YTDLP_DEFAULT_SUBTITLE_LANG": "en",
                "YTDLP_CHARACTER_LIMIT": "25000",
                "YTDLP_MAX_TRANSCRIPT_LENGTH": "50000",
                "YTDLP_COOKIES_FROM_BROWSER": "chrome",
                "YTDLP_COOKIES_FILE": "/path/to/cookies.txt"
            }
        }
    }
}

You can run yt-dlp with MCP-compatible agents to search, fetch metadata, download videos or audio, and extract transcripts and subtitles. This server is designed to be easy to drop into MCP workflows so your AI agents can interact with video content across platforms with safety and structure.

How to use

You connect an MCP client to the yt-dlp MCP server to perform capabilities like searching, fetching video metadata, downloading videos or audio, and obtaining transcripts or subtitles. Use natural language prompts to trigger tools such as searching for videos, listing available subtitles, downloading content in a chosen format, or getting a clean metadata summary. Tools are designed to be intuitive and predictable, returning structured data or files that your agent can process.

How to install

Prerequisites you need before starting:

Install yt-dlp on your operating system using the following commands.

# Windows
winget install yt-dlp
```
```bash
# macOS
brew install yt-dlp
```
```bash
# Linux
pip install yt-dlp

How to run via Dive Desktop (MCP client)

Install the MCP server as a stdio process and connect it to your MCP client using the provided configuration.

{
  "mcpServers": {
    "yt-dlp": {
      "command": "npx",
      "args": ["-y", "@kevinwatt/yt-dlp-mcp"]
    }
  }
}

Manual installation

If you prefer installing globally and running directly, use the following command.

npm install -g @kevinwatt/yt-dlp-mcp

Available tools

ytdlp_search_videos

Search YouTube with pagination support and return results in JSON or Markdown formats, including titles, channels, durations, and URLs.

ytdlp_list_subtitle_languages

List all subtitle languages available for a video, including formats and whether they are auto-generated.

ytdlp_download_video_subtitles

Download subtitles in VTT format with timestamps for a given video and optional language.

ytdlp_download_transcript

Generate a clean plain text transcript for a video in an optional language.

ytdlp_download_video

Download video to the Downloads folder with a configurable resolution and optional start/end times for trimming.

ytdlp_download_audio

Extract and download the best quality audio (M4A/MP3) from a video.

ytdlp_get_video_metadata

Extract comprehensive video metadata in JSON, with optional field filtering.

ytdlp_get_video_metadata_summary

Get a human-readable metadata summary for quick insights.