Skip to content
Agentmart
Submit a tool

Mpv MCP Server

Control mpv media player — playback, playlists, YouTube streaming, and downloads.

Connector by arijit-gogoi · GitHub account verified by the MCP Registry

IndexedLicense unknownLocal (stdio)★ 1
Write a review

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/arijit-gogoi-mpv-mcp-server

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

Control mpv media player — playback, playlists, YouTube streaming, and downloads.

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools
4 read · 12 write · 1 delete
Secrets
None asked for
Install scripts
Not scanned yet
Runs as
Node.js package

Tools by what they do 17

Read from the source code; the running server may list different tools.

Read 4 · Look things up without changing anything.

  • mpv_browse
  • mpv_info
  • mpv_playlist
  • mpv_status

Write 12 · Create, change, send or run things.

  • mpv_add
  • mpv_download
  • mpv_load_playlist
  • mpv_next
  • mpv_pause
  • mpv_play
  • mpv_prev
  • mpv_resume
  • mpv_seek
  • mpv_tag
  • mpv_volume
  • mpv_youtube

Delete 1 · Delete, drop, revoke or wipe things.

  • mpv_stop

Secrets and settings it asks for

Other settings (environment variables or headers).

  • MPV_DOWNLOAD_DIR
  • MPV_IPC_PATH
  • MPV_MEDIA_DIRS
  • MPV_PATH

Files it touches

  • Any path the agent passes to its tools

Tools (17)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • mpv_addAdd to Playlist

    Add a file to the playlist by path or search term. Use mode "append-play" to start playing it immediately.

  • mpv_browseBrowse Music Libraryread-only

    List available music and video files. Optionally filter by search term or directory.

  • mpv_downloadDownload from YouTube

    Download audio or video from YouTube. Specify format: "audio" for MP3, "video" for full video.

  • mpv_infoTrack Inforead-only

    Get metadata (artist, title, album, genre, etc.) for a file by search term, or the currently playing track if omitted.

  • mpv_load_playlistLoad Playlist File

    Load a playlist file (.txt, .m3u). Omit path to list available playlists.

  • mpv_nextNext Track

    Skip to the next track in the playlist.

  • mpv_pausePause Playback

    Pause the currently playing track.

  • mpv_playPlay Music/Video

    Play a file by path or search term. Searches your Music and Videos folders when given a name like "sultans of swing".

  • mpv_playlistShow Playlistread-only

    Show the current playlist with track numbers and the active track marked.

  • mpv_prevPrevious Track

    Go back to the previous track in the playlist.

  • mpv_resumeResume Playback

    Resume playback if paused.

  • mpv_seekSeek

    Seek to a position. Accepts seconds ("90"), timestamp ("1:30"), or relative ("+10", "-30").

  • mpv_statusmpv Statusread-only

    Get current mpv playback status: track title, position, duration, volume, and pause state.

  • mpv_stopStop Playbackcan change or delete data

    Stop playback and clear the current file. The playlist is preserved.

  • mpv_tagTag File

    Write metadata tags to a media file using ffmpeg. Can target a file by search term. Infers artist/title from the filename if not provided.

Show 2 more tools
  • mpv_volumeGet/Set Volume

    Get or set the playback volume. Provide a level (0-150) to set, or omit to get current volume.

  • mpv_youtubePlay from YouTube

    Search YouTube and stream the result through mpv. Accepts a search query or a direct YouTube URL.

Signals

Stars
1
Forks
0
Open issues
0
Last commit
Apr 12, 2026 (6 months ago)
Last release
Apr 12, 2026 (6 months ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name
io.github.arijit-gogoi/mpv-mcp-server
Version
1.2.0
Auth
No auth
Packages
npm mpv-mcp-server
License
License unknown
Repository
github.com/arijit-gogoi/mpv-mcp-server
First seen
Oct 24, 2026
Last checked
Oct 25, 2026
Source
Official MCP Registrygithub-graphql
Cite this page

Mpv MCP Server. Agent Mart. https://agentmart.dev/connectors/arijit-gogoi-mpv-mcp-server (last updated 2026-10-25)