Skip to content
MCP server

yt-dlp MCP

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

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
1.0.0
Listing updated
today

About yt-dlp MCP

yt-dlp MCP is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add ytdlp-mcp -- npx -y @fanyzp/ytdlp-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "ytdlp-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@fanyzp/ytdlp-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "ytdlp-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@fanyzp/ytdlp-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "ytdlp-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@fanyzp/ytdlp-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "ytdlp-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@fanyzp/ytdlp-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "ytdlp-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@fanyzp/ytdlp-mcp"
      ]
    }
  }
}

Configuration

  • YTDLP_DOWNLOAD_DIRDirectory where downloaded files are saved.
  • YTDLP_COOKIES_FILEPath to a Netscape-format cookies.txt file for sites that require a signed-in session. Never paste cookie contents into chat.
  • YTDLP_BINPath to the yt-dlp binary.
  • FFMPEG_BINPath to the ffmpeg binary, used for merging and converting.

Pricing

Open source

yt-dlp MCP FAQ

Is yt-dlp MCP free?

Yes. yt-dlp MCP is open source, so you can use and self-host it for free.

How do I add yt-dlp MCP to Claude Code?

Run this command in your terminal: claude mcp add ytdlp-mcp -- npx -y @fanyzp/ytdlp-mcp

What are the best alternatives to yt-dlp MCP?

The closest alternatives to yt-dlp MCP are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

Alternatives to yt-dlp MCP

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  4. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media