👥

mcp-ytmusic

Enables users to search the YouTube Music catalog and manage playlists using natural language. It provides tools for searching songs, albums, and artists, as well as performing playlist operations like creating, adding, and deleting tracks.

0 installs

Trust: 34 — Low

Social

Ask AI about mcp-ytmusic

I know everything about mcp-ytmusic. Ask me about installation, configuration, usage, or troubleshooting.

0/500

Loading tools...

Reviews

Documentation

mcp-ytmusic

YouTube Music MCP server for Claude Code. Search the catalog and manage playlists via natural language.

Tools

Tool	Actions	Description
`search`	—	Search songs, videos, albums, artists, playlists
`playlist`	`list`, `create`, `add`, `tracks`, `delete`	Manage playlists
`config`	`info`, `auth_status`	Check configuration and auth

Setup

# Clone and install
git clone https://github.com/alexcook/mcp-ytmusic.git
cd mcp-ytmusic
python3 -m venv venv
source venv/bin/activate
pip install -e .

# Initialize config directory
ytmusic-mcp init

# Authenticate (paste browser headers from Chrome DevTools on music.youtube.com)
ytmusic-mcp auth

# Verify
ytmusic-mcp status

Claude Code Integration

Add to ~/.claude/mcp.json:

{
  "mcpServers": {
    "YouTube Music": {
      "command": "/path/to/mcp-ytmusic/venv/bin/python",
      "args": ["-m", "ytmusic_mcp"]
    }
  }
}

Auth

Uses browser cookie authentication via ytmusicapi. One-time setup:

Open Chrome → https://music.youtube.com (make sure you're logged in)
Open DevTools (F12) → Network tab
Click any request to music.youtube.com
Right-click → Copy → Copy request headers
Run ytmusic-mcp auth and paste when prompted

Credentials are saved to ~/.config/ytmusic-mcp/browser.json and are valid for ~2 years.