fanyzp avatar

yt-dlp MCP

fanyzp/ytdlp-mcp

Download video and audio with yt-dlp via AI agents: inspect, batch, subtitles, convert.

GitHub stars
1
tools
13
transport
STDIO
env vars
4
last updated
Nov 17, 2026

Tools

13 tools

Public tool metadata for what this MCP can expose to an agent.

probeRead title, duration, uploader, views, thumbnail, and description

Read title, duration, uploader, views, thumbnail, and description

No parameter schema in public metadata yet.

formatsList available media formats, quality, and estimated sizes

List available media formats, quality, and estimated sizes

No parameter schema in public metadata yet.

supportedCheck whether a URL matches a locally installed yt-dlp extractor

Check whether a URL matches a locally installed yt-dlp extractor

No parameter schema in public metadata yet.

inspectRecommend a download action, quality, and available resolutions

Recommend a download action, quality, and available resolutions

No parameter schema in public metadata yet.

get_videoDownload video, default output is MP4

Download video, default output is MP4

No parameter schema in public metadata yet.

get_audioExtract audio as Opus, MP3, or M4A

Extract audio as Opus, MP3, or M4A

No parameter schema in public metadata yet.

get_subtitlesDownload manual or auto-generated subtitles as VTT

Download manual or auto-generated subtitles as VTT

No parameter schema in public metadata yet.

adviseAnswer yt-dlp configuration questions

Answer yt-dlp configuration questions

No parameter schema in public metadata yet.

queuePreview a batch of URLs and per-item download plans

Preview a batch of URLs and per-item download plans

No parameter schema in public metadata yet.

fetch_allDownload a batch of URLs with optional delays

Download a batch of URLs with optional delays

No parameter schema in public metadata yet.

watchList entries from a playlist or channel without downloading

List entries from a playlist or channel without downloading

No parameter schema in public metadata yet.

searchSearch YouTube or SoundCloud and return compact metadata

Search YouTube or SoundCloud and return compact metadata

No parameter schema in public metadata yet.

convertRe-encode a local video using FFmpeg presets

Re-encode a local video using FFmpeg presets

No parameter schema in public metadata yet.

Sponsors

Configuration

YTDLP_DOWNLOAD_DIR

Directory where downloaded files are saved.

YTDLP_COOKIES_FILE

Path to a Netscape-format cookies.txt file for sites that require a signed-in session. Never paste cookie contents into chat.

YTDLP_BINdefault: yt-dlp

Path to the yt-dlp binary.

FFMPEG_BINdefault: ffmpeg

Path to the ffmpeg binary, used for merging and converting.

Readme

ytdlp-mcp

License Version Node.js Platforms

An MCP server that lets AI agents inspect, download, and convert video and audio using yt-dlp and FFmpeg through natural language instructions.

Example

Send a link, get the file. Or type /ytdlp-mcp in OpenCode, Gemini CLI, or Claude Code:

chat

Install

git clone https://github.com/fanyzp/ytdlp-mcp.git && cd ytdlp-mcp && npm run setup

Requires yt-dlp, ffmpeg, Node 18. Or copy PROMPT.md into any AI agent and let it install for you.

Tools


View the full README on GitHub

Details

Repository
github.com/fanyzp/ytdlp-mcp
Category
Media & Entertainment
Package
@fanyzp/ytdlp-mcp
Transport
STDIO
Registry
MCP registry, active

More from fanyzp

Related Media & Entertainment MCP servers

View all
1mkturner74 avatarBotversemkturner74/botverse-mcpTranscode/conform/splice video, convert docs, transcribe audio for AI agents. Free $1 trial.1stars
2rsmdt avatarMultimodalrsmdt/multimodal-mcpMulti-provider media generation — images, video, audio, and transcription via a unified interface1stars
3joaoestella avatarmediasensejoaoestella/mediasenseLet Claude listen to audio and watch video: transcribe, summarize and edit recordings and links.1stars
4makersmcp avatarMakersMCPmakersmcp/makersmcpFree kits for makers: brand kits, fonts, screenshots, films, music, captions and video formats.1stars
5malkreide avatarSrgssr Mcpmalkreide/srgssr-mcpSRG SSR weather, video, audio, EPG, Polis1stars
6mohanvishe avatarMediaHarvestmohanvishe/mediaharvestRead video transcripts, see every format, and download video or audio from YouTube and more.1stars