yt-player MCP Server

An MCP server and media playback service that lets an AI assistant play music on a real speaker. Ask your assistant to "play some lo-fi", "queue the next three tracks from that album", or "add this…

Local serverstdio

What is the yt-player MCP Server?

yt-player is an MCP project maintained in the karunstha/yt-player repository. The maintainer describes its purpose as “An MCP server and media playback service that lets an AI assistant play music on a real speaker. Ask your assistant to "play some lo-fi"…”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using uvx. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares MEDIA_SERVICE_URL. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-13.

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
AreaTools
Statushealth, get_playback_state, get_current_track
Searchsearch_media
Playbackplay_media, pause_playback, resume_playback, stop_playback, seek_playback, next_track, previous_track, set_volume, set_shuffle, set_repeat
Historyget_playback_history (paginated with next_before)
Queueget_queue, append_queue_track, insert_queue_track_next, queue_playlist, remove_queue_item, clear_queue, replace_queue_with_playlist
Playlistslist_playlists, get_playlist, create_playlist, rename_playlist, delete_playlist, add_track_to_playlist, add_tracks_to_playlist, add_current_track_to_playlist…
search_typeSearches
music_videosYouTube Music videos
podcastsYouTube Music podcast episodes
videosAll of YouTube

How to install the yt-player MCP Server

{
  "mcpServers": {
    "yt-player": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/karunstha/yt-player",
        "yt-player-mcp"
      ],
      "env": {
        "MEDIA_SERVICE_URL": "http://127.0.0.1:5454"
      }
    }
  }
}

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

Configuration

VariableDescriptionRequired
MEDIA_SERVICE_URLDeclared in the maintainer’s client configuration.Check documentation