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

Related MCP server: YouTube MCP Integration

Installation

Prerequisites

Install yt-dlp based on your operating system:

With Dive Desktop

1. Click "+ Add MCP Server" in Dive Desktop

2. Copy and paste this configuration:

3. 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:

Manual Start

If needed, start the server manually:

Requirements

• Node.js 20+

• yt-dlp in system PATH

• MCP-compatible LLM service

Documentation

• API Reference

• Configuration

• Error Handling

• Contributing

License

MIT

Author

Dewei Yen