YouTube Music

🎶 A simple MCP Server that search & plays youtube music tracks

typescript

9

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "instructa-mcp-youtube-music": {
      "command": "npx",
      "args": [
        "-y",
        "@instructa/mcp-youtube-music"
      ],
      "env": {
        "YOUTUBE_API_KEY": "<INSERT_API_KEY_HERE>"
      }
    }
  }
}

This MCP server lets you search YouTube Music for tracks and open them directly in your browser from your AI assistant. It makes it easy to find and play music on YouTube Music without leaving your conversational workflow.

How to use

You interact with the YouTube Music MCP through your MCP client by calling its available tools. Use searchTrack to find tracks by name and playTrack to locate a specific track and open it in your default browser. You can combine these tools with your assistant workflows to queue, play, or preview songs directly from YouTube Music without juggling multiple apps.

How to install

Prerequisites you need before installing this MCP server:

• Node.js and npm are installed on your machine.

Steps to run the MCP server locally:

Additional setup notes

Your YouTube API key is required to run this MCP server. Obtain a valid Google YouTube API Key and provide it in the MCP configuration.

Configure the MCP client with the following settings to enable the YouTube Music MCP. This example uses npx to run the MCP package and passes your API key as an environment variable.

{
  "mcpServers": {
    "youtube_music_mcp": {
      "command": "npx",
      "args": ["-y", "@instructa/mcp-youtube-music"],
      "env": {
        "YOUTUBE_API_KEY": "<INSERT_API_KEY_HERE>"
      }
    }
  }
}

Available tools

searchTrack

Search for tracks on YouTube Music by name and return matching results.

playTrack

Open and play a selected track directly in your default browser based on a search.