Control mpv media player — playback, playlists, YouTube streaming, and downloads.
Connect Runs on your machine
claude mcp add mpv-mcp-server -e MPV_PATH=<MPV_PATH> -e MPV_IPC_PATH=<MPV_IPC_PATH> -e MPV_MEDIA_DIRS=<MPV_MEDIA_DIRS> -e MPV_DOWNLOAD_DIR=<MPV_DOWNLOAD_DIR> -- npx -y [email protected]{
"mcpServers": {
"mpv-mcp-server": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"MPV_PATH": "<MPV_PATH>",
"MPV_IPC_PATH": "<MPV_IPC_PATH>",
"MPV_MEDIA_DIRS": "<MPV_MEDIA_DIRS>",
"MPV_DOWNLOAD_DIR": "<MPV_DOWNLOAD_DIR>"
}
}
}
}{
"mcpServers": {
"mpv-mcp-server": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"MPV_PATH": "<MPV_PATH>",
"MPV_IPC_PATH": "<MPV_IPC_PATH>",
"MPV_MEDIA_DIRS": "<MPV_MEDIA_DIRS>",
"MPV_DOWNLOAD_DIR": "<MPV_DOWNLOAD_DIR>"
}
}
}
}{
"servers": {
"mpv-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"MPV_PATH": "<MPV_PATH>",
"MPV_IPC_PATH": "<MPV_IPC_PATH>",
"MPV_MEDIA_DIRS": "<MPV_MEDIA_DIRS>",
"MPV_DOWNLOAD_DIR": "<MPV_DOWNLOAD_DIR>"
}
}
}
}Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
MPV_PATHOptional | Path to mpv executable (default: mpv from PATH) |
MPV_IPC_PATHOptional | IPC socket path (default: named pipe on Windows, Unix socket on macOS/Linux) |
MPV_MEDIA_DIRSOptional | Comma-separated media directories to scan (default: ~/Music,~/Videos) |
MPV_DOWNLOAD_DIROptional | Download directory for YouTube downloads (default: ~/Downloads) |
Details
| Package | [email protected] (NPM, stdio) |
| First published | 12 Apr 2026 |
| Last updated | 12 Apr 2026 |
| Registry name | io.github.arijit-gogoi/mpv-mcp-server |
More marketing and seo servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.