SSyncDev

YTDL RMCP MCP Server

Rust MCP server and CLI for yt-dlp search, downloads, metadata, transfers, and Plex playlists.

Local serverstdio

What is the YTDL RMCP MCP Server?

Rust MCP server and CLI for yt-dlp search, downloads, metadata, transfers, and Plex playlists.

The short version

MCP server and CLI for yt-dlp: search and download media, embed metadata and cover art, then deliver to local, SSH, or rclone targets and Plex.

  • Searches YouTube through yt-dlp without downloading media
  • Downloads audio, video, or both into a staging tree, tags audio metadata, and
  • Optionally fingerprints audio through AcoustID/MusicBrainz and syncs completed
  • Builds Plex playlists from successful transfer history and drains server-made
  • Exposes an MCP App search UI for hosts that can render embedded widgets
  • Keeps a JSONL ledger for repeat-safe downloads and stats

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
partialan error occurred but some files were still produced.
failederrored with no files.
skippednothing new (already in the archive).
metadata_retagMusicBrainz/AcoustID auto-retag summary (attempted,
plex_playlistPlex playlist summary (playlist, matched, added,
history_errorset when the download succeeded but the JSONL ledger append
host/path/to/library — SSH target. Uses the existing rsync/scp flow and
remotepath/to/library — rclone target with a relative remote path. Uses rclone copy; rclone must be
rcloneremote:/path/to/library — explicit rclone target for an absolute remote path; without the rclone: prefix, host:/path remains SSH by design.

How to install the YTDL RMCP MCP Server

{
  "mcpServers": {
    "ytdl-rmcp": {
      "command": "npx",
      "args": ["-y", "@dinglebear/rytdl"],
      "env": {
        "YTDLP_TARGET_PATH": "your-value",
        "YTDLP_VIDEO_TARGET_PATH": "your-value",
        "YTDLP_AUTO_UPDATE": "your-value",
        "YTDLP_MAX_AGE_DAYS": "your-value",
        "YTDLP_EXTRACTOR_ARGS": "your-value",
        "FPCALC_PATH": "your-value",
        "YTDLP_PLEX_URL": "your-value",
        "YTDLP_PLEX_TOKEN": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
YTDLP_TARGET_PATHFilesystem location the server is allowed to use.Optional
YTDLP_VIDEO_TARGET_PATHFilesystem location the server is allowed to use.Optional
YTDLP_AUTO_UPDATEConfiguration value read at startup.Optional
YTDLP_MAX_AGE_DAYSConfiguration value read at startup.Optional
YTDLP_EXTRACTOR_ARGSConfiguration value read at startup.Optional
FPCALC_PATHFilesystem location the server is allowed to use.Optional
YTDLP_PLEX_URLEndpoint or connection string the server talks to.Yes
YTDLP_PLEX_TOKENCredential the server authenticates with.Yes

Example prompts to try

  • “Use YTDL RMCP to Self.”
  • “Use YTDL RMCP to Self-installing.”
  • “Use YTDL RMCP to Repeat-safe.”

Frequently asked questions

Rust MCP server and CLI for yt-dlp search, downloads, metadata, transfers, and Plex playlists. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.