yt-music-mcp

YouTube Music MCP server for Claude Code. Search songs, manage playlists, and interact with YouTube Music through the YouTube Data API v3.

Built with NestJS + @rekog/mcp-nest using STDIO transport.

Tools

Tool	Description
search_songs	Search YouTube Music for songs
search_artists	Search for artist channels
get_playlists	List your playlists
create_playlist	Create a new playlist
add_to_playlist	Add videos to a playlist
remove_from_playlist	Remove items from a playlist
get_playlist_items	Get all items in a playlist
auth_callback	Complete Google OAuth authentication

Setup

1. Install dependencies

pnpm install

2. Build

pnpm run build

3. Configure Claude Code

Add to ~/.claude.json:

{
  "mcpServers": {
    "yt-music": {
      "command": "node",
      "args": ["/path/to/yt-music-mcp/dist/main.js"],
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id",
        "GOOGLE_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

4. Authenticate

On first use, any tool that requires auth will return an OAuth URL. Visit it in your browser, authorize, and use the auth_callback tool with the code.

Tokens are stored in ~/.yt-music-mcp/tokens.json.

Google OAuth Credentials

You need a Google Cloud project with the YouTube Data API v3 enabled and OAuth 2.0 credentials configured.

Required scope: https://www.googleapis.com/auth/youtube

License

MIT