yt-dlp-mcp

An MCP server implementation that integrates with yt-dlp, providing video and audio content download capabilities (e.g. YouTube, Facebook, Tiktok, etc.) for LLMs.

Features

Subtitles: Download subtitles in SRT format for LLMs to read
Video Download: Save videos to your Downloads folder with resolution control
Audio Download: Save audios to your Downloads folder
Privacy-Focused: Direct download without tracking
MCP Integration: Works with Dive and other MCP-compatible LLMs

Installation

Prerequisites

Install yt-dlp based on your operating system:

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

With Dive Desktop

Click "+ Add MCP Server" in Dive Desktop
Copy and paste this configuration:

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

Click "Save" to install the MCP server

Tool Documentation

list_subtitle_languages
- List all available subtitle languages and their formats for a video (including auto-generated captions)
- Inputs:
  - url (string, required): URL of the video
download_video_subtitles
- Download video subtitles in any available format. Supports both regular and auto-generated subtitles
- Inputs:
  - url (string, required): URL of the video
  - language (string, optional): Language code (e.g., 'en', 'zh-Hant', 'ja'). Defaults to 'en'
download_video
- Download video to user's Downloads folder
- Inputs:
  - url (string, required): URL of the video
  - resolution (string, optional): Video resolution ('480p', '720p', '1080p', 'best'). Defaults to '720p'
download_audio
- Download audio in best available quality (usually m4a/mp3 format) to user's Downloads folder
- Inputs:
  - url (string, required): URL of the video

Usage Examples

Ask your LLM to:

"List available subtitles for this video: https://youtube.com/watch?v=..." "Download a video from facebook: https://facebook.com/..." "Download Chinese subtitles from this video: https://youtube.com/watch?v=..." "Download this video in 1080p: https://youtube.com/watch?v=..." "Download audio from this YouTube video: https://youtube.com/watch?v=..."

Manual Start

If needed, start the server manually:

npx @kevinwatt/yt-dlp-mcp

Requirements

Node.js 20+
yt-dlp in system PATH
MCP-compatible LLM service

Documentation

License

MIT

Author

Dewei Yen

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Connects 'yt-dlp' with LLMs via the Model Context Protocol, allowing users to download YouTube content and integrate it with Dive and other MCP-compatible LLMs.

Related Resources

Reddit Discussion about this server

Related MCP Servers

YouTube MCP Server
anaisbetts
A
security
A
license
A
quality
Uses yt-dlp to download subtitles from YouTube and connects it to claude.ai via Model Context Protocol.
Last updated -
1
189
452
MIT License
YouTube MCP Integration
-
security
F
license
-
quality
An MCP server that enables LLMs to search YouTube, retrieve video information, and access video transcripts through standardized tools.
YDB MCPofficial
ydb-platform
A
security
A
license
A
quality
Model Context Protocol server for YDB databases that enables AI-powered database operations and natural language interactions with YDB instances from any LLM that supports MCP.
Last updated -
5
22
Apache 2.0
Cross-LLM MCP Server
JamesANZ
A
security
A
license
A
quality
A Model Context Protocol server that provides unified access to multiple LLM APIs including ChatGPT, Claude, and DeepSeek, allowing users to call different LLMs from MCP-compatible clients and combine their responses.
Last updated -
7
21
2
MIT License

View all related MCP servers

YouTube MCP Server