Skip to main content
Glama

mcp-yt-dlp

MCP server wrapping yt-dlp for downloading videos and audio from URLs.

Works with Claude Code, Codex, Claude Desktop, Cursor, VS Code, Windsurf, and any MCP-compatible client.

Prerequisites

  • Node.js 18+

  • yt-dlp installed and in PATH

Install yt-dlp:

brew install yt-dlp

Related MCP server: metube-mcp

Installation

Claude Code

claude mcp add yt-dlp -- npx -y github:pauloFroes/mcp-yt-dlp

Codex

Add to your codex.toml:

[mcp.yt-dlp]
command = "npx"
args = ["-y", "github:pauloFroes/mcp-yt-dlp"]

Claude Desktop

Add to claude_desktop_config.json:

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

Cursor

Add to .cursor/mcp.json:

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

VS Code

Add to .vscode/mcp.json:

{
  "servers": {
    "yt-dlp": {
      "command": "npx",
      "args": ["-y", "github:pauloFroes/mcp-yt-dlp"]
    }
  }
}

Windsurf

Add to ~/.windsurf/mcp.json:

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

Available Tools

Tool

Description

check_dependencies

Check if yt-dlp is installed and available in PATH

get_video_info

Get video metadata (title, duration, resolution, fps, thumbnail)

download_video

Download video from URL to local file (best quality MP4)

download_audio

Download audio only from URL as MP3

License

MIT

F
license - not found
-
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/pauloFroes/mcp-yt-dlp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server