# 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

```bash
# 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`:

```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.