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:

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

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