Claude MarketplacesSubmit

Mpv Mcp Server

arijit-gogoi/mpv-mcp-server

Brings mpv's JSON IPC protocol into Claude as MCP tools. You get the usual playback controls (play, pause, seek, volume) plus library browsing across configured directories, playlist management, and a full YouTube integration via yt-dlp for search, streaming, and downloads. It also wraps ffprobe for reading metadata and ffmpeg for writing tags back to files. The server spawns mpv in detached mode if it's not already running, so your player keeps going even after the MCP session ends. Reach for this when you want voice-driven music control or need to script media operations without leaving your editor.

GitHub stars: 1
tools: 17
transport: STDIO
env vars: 4
last updated: Apr 12, 2026

Tools

17 tools

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

mpv_playPlay a file by path or search term

Play a file by path or search term

No parameter schema in public metadata yet.

mpv_pausePause playback

Pause playback

No parameter schema in public metadata yet.

mpv_resumeResume playback

Resume playback

No parameter schema in public metadata yet.

mpv_stopStop playback

Stop playback

No parameter schema in public metadata yet.

mpv_statusGet current playback status

Get current playback status

No parameter schema in public metadata yet.

mpv_seekSeek to position ("90", "1:30", "+10", "-30")

Seek to position ("90", "1:30", "+10", "-30")

No parameter schema in public metadata yet.

mpv_volumeGet or set volume (0-150)

Get or set volume (0-150)

No parameter schema in public metadata yet.

mpv_browseList and search available media files

List and search available media files

No parameter schema in public metadata yet.

mpv_playlistShow current playlist

Show current playlist

No parameter schema in public metadata yet.

mpv_addAdd a track to the playlist

Add a track to the playlist

No parameter schema in public metadata yet.

mpv_load_playlistLoad a playlist file (.m3u, .pls, .txt)

Load a playlist file (.m3u, .pls, .txt)

No parameter schema in public metadata yet.

mpv_nextSkip to next track

Skip to next track

No parameter schema in public metadata yet.

mpv_prevGo to previous track

Go to previous track

No parameter schema in public metadata yet.

mpv_youtubeSearch YouTube and stream through mpv (supports append mode)

Search YouTube and stream through mpv (supports append mode)

No parameter schema in public metadata yet.

mpv_downloadDownload from YouTube (audio or video)

Download from YouTube (audio or video)

No parameter schema in public metadata yet.

mpv_infoGet metadata for the current track or any file by search term

Get metadata for the current track or any file by search term

No parameter schema in public metadata yet.

mpv_tagWrite metadata tags (artist, title, album, genre, date, comment) to a file

Write metadata tags (artist, title, album, genre, date, comment) to a file

No parameter schema in public metadata yet.

Sponsors

Promote your product hereReach 125k+ visitors monthly Promote your product hereReach 125k+ visitors monthly

Agent CaffeineSponsoredClose your lid, come back to finished work

SnugSponsoredThe clipboard manager for the AI era Promote your product hereReach 125k+ visitors monthly

WaxSponsoredBlock anything with supervision, without erasing your iPhone Promote your product hereReach 125k+ visitors monthly

knobsSponsoredSee your site on any phone, any day, in any language

Configuration

MPV_PATH

Path to mpv executable (default: mpv from PATH)

MPV_IPC_PATH

IPC socket path (default: named pipe on Windows, Unix socket on macOS/Linux)

MPV_MEDIA_DIRS

Comma-separated media directories to scan (default: ~/Music,~/Videos)

MPV_DOWNLOAD_DIR

Download directory for YouTube downloads (default: ~/Downloads)

Readme

mpv-mcp-server

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.

Prerequisites

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

Quick Start

Claude Code

Add to your project's .mcp.json:

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

Or add at user scope (available in all projects):

claude mcp add mpv --scope user -- npx -y mpv-mcp-server

Claude Desktop

Add to your Claude Desktop config:

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

With environment overrides

View the full README on GitHub

Details

Repository: github.com/arijit-gogoi/mpv-mcp-server
Category: Media & Entertainment
Package: mpv-mcp-server
Transport: STDIO
Registry: MCP registry, active

Related Media & Entertainment MCP servers

1

Voxboska/voxNative macOS MCP server for voice I/O — Swift binary, SFSpeechRecognizer + ElevenLabs TTS.1stars

2

deAPI MCP Serverdeapi-ai/mcp-server-deapi39 AI tools: transcription, video description, image & video generation, TTS, music, OCR via deAPI1stars

3

Kie Mcpelibarnett/kie-mcpMCP for kie.ai: 45+ image, 70+ video, 20+ audio models with model intelligence1stars

4

Botversemkturner74/botverse-mcpTranscode/conform/splice video, convert docs, transcribe audio for AI agents. Free $1 trial.1stars

5

Multimodalrsmdt/multimodal-mcpMulti-provider media generation — images, video, audio, and transcription via a unified interface1stars

6

mediasensejoaoestella/mediasenseLet Claude listen to audio and watch video: transcribe, summarize and edit recordings and links.1stars