SSyncDev

Mpv MCP Server

MCP server for controlling mpv media player — playback, playlists, YouTube streaming and downloading

Local serverstdioGo

What is the Mpv MCP Server?

MCP server for controlling mpv media player — playback, playlists, YouTube streaming and downloading

What it actually does

MCP server for controlling mpv media player. Browse your music library, control playback, stream from YouTube, and download tracks — all from inside an MCP client like Claude Code.

Configuration

  • mpv — media player (must be on your PATH, or set MPV_PATH) - Node.js 22+ - yt-dlp (optional) — required for YouTube streaming and downloading - ffmpeg (optional) — required for audio extraction, metadata reading (ffprobe), and tagging

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
mpv_playPlay a file by path or search term
mpv_pausePause playback
mpv_resumeResume playback
mpv_stopStop playback
mpv_statusGet current playback status
mpv_seekSeek to position ("90", "1:30", "+10", "-30")
mpv_volumeGet or set volume (0-150)
mpv_browseList and search available media files
mpv_playlistShow current playlist
mpv_addAdd a track to the playlist
mpv_load_playlistLoad a playlist file (.m3u, .pls, .txt)
mpv_nextSkip to next track
mpv_prevGo to previous track
mpv_youtubeSearch YouTube and stream through mpv (supports append mode)
mpv_downloadDownload from YouTube (audio or video)
mpv_infoGet metadata for the current track or any file by search term
mpv_tagWrite metadata tags (artist, title, album, genre, date, comment) to a file

How to install the Mpv MCP Server

{
  "mcpServers": {
    "mpv": {
      "command": "npx",
      "args": [
        "-y",
        "mpv-mcp-server"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • mpv — media player (must be on your PATH, or set MPV_PATH) - Node.js 22+ - yt-dlp (optional) — required for YouTube streaming and downloading - ffmpeg (optional) — required for audio extraction, metadata reading (ffprobe), and tagging

Example prompts to try

  • “Use Mpv to Playback.”
  • “Use Mpv to Library.”
  • “Use Mpv to YouTube.”

Frequently asked questions

MCP server for controlling mpv media player — playback, playlists, YouTube streaming and downloading Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.