MCP server for YouTube Music — lets AI agents search, browse, and manage your library via ytmusicapi.
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"yt-music-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# yt-music-mcp An [MCP](https://modelcontextprotocol.io) server that exposes [YouTube Music](https://music.youtube.com) to AI agents, via [`ytmusicapi`](https://github.com/sigma67/ytmusicapi). Agents can search the catalog, browse artists/albums/songs, read the user's library and history, and create/edit/delete playlists, rate songs, and manage subscriptions. --- ## Quickstart You need two things in your config: 1. **A way to run the server** — recommended: `uvx yt-music-mcp` (no install needed, [`uv`](https://docs.astral.sh/uv/) fetches it on first use). 2. **Your YouTube Music auth** — a one-time capture of request headers from `music.youtube.com`, stored either inline in the config or in a `browser.json` file. ### 1. Capture auth (one time, ~2-year validity) Skip this if you only need public search/browsing. 1. Open <https://music.youtube.com> in a desktop browser, logged in. 2. Open DevTools (F12) → **Network** tab. 3. Click around to trigger traffic, then find any request to `/youtubei/v1/...`. 4. Right-click that request → **Copy** → **Copy request headers**. Then run **one** of: ```bash # Option A — print the JSON to stdout so you can paste it into your config. uvx yt-music-mcp setup-auth --stdout # Option B — write a browser.json file you'll reference by path. uvx yt-music-mcp setup-auth --out ~/.yt-music-mcp/browser.json ``` Paste your headers when prompted, then Ctrl-D (Ctrl-Z + Enter on Windows). ### 2. Configure your MCP client Pick your client and paste one of the snippets below. Use the **inline JSON** variant if you used `--stdout`, or the **file path** variant if you used `--out`. #### Claude Desktop Config file: | OS | Path | |---|---| | Windows | `%APPDATA%\Claude\claude_desktop_config.json` | | macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` | | Linux | `~/.config/Claude/claude_desktop_config.json` | **Inline JSON (recommended):** ```json { "mcpServers": { "yt-music": { "command": "uvx", …
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.