youtube-music-mcp
Provides read-only tools for exploring a local YouTube Music library, including listing liked songs and playlists, searching the catalog, summarizing favorites by artist/album/year, and exporting favorites to CSV or JSON.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@youtube-music-mcp Show me my liked songs"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
YouTube Music MCP
Servidor MCP y plugin personal de Codex para consultar YouTube Music de forma local y de solo lectura. Permite explorar favoritos, playlists y el catálogo sin incorporar credenciales ni datos privados al repositorio.
Funciones
Listar y filtrar canciones marcadas con Me gusta.
Listar playlists de la biblioteca.
Obtener el contenido de la playlist de favoritos (
LM).Buscar canciones, vídeos, álbumes, artistas y playlists.
Buscar por género incorporándolo a la consulta del catálogo.
Resumir favoritos por artista, álbum y año.
Exportar favoritos a CSV o JSON.
Trabajar con API en vivo o con snapshots privados capturados desde Chrome.
Related MCP server: yt-music-mcp
Privacidad y arquitectura
El servidor tiene dos modos de lectura:
live_api: usa una sesión local deytmusicapi.browser_snapshot: usa snapshots de metadatos generados desde una sesión de Chrome ya iniciada, sin guardar cookies, cabeceras ni contraseñas.
Los archivos privados se almacenan fuera del repositorio:
~/.config/youtube-music-mcp/browser.json
~/.config/youtube-music-mcp/liked-snapshot.json
~/.config/youtube-music-mcp/playlists-snapshot.jsonEl MCP no expone herramientas que modifiquen la cuenta.
Herramientas MCP
Herramienta | Descripción |
| Comprueba la fuente de datos disponible. |
| Lista y filtra canciones favoritas. |
| Lista playlists guardadas. |
| Obtiene canciones de una playlist. |
| Busca en el catálogo por texto, artista o género. |
| Resume artistas, álbumes y años. |
| Exporta favoritos a CSV o JSON. |
Instalación local
Requisitos: Python 3.11 o posterior y uv.
git clone https://github.com/eduardoddddddd/youtube-music-mcp.git
cd youtube-music-mcp
uv sync
./scripts/configure-local-path.shEl último comando adapta .mcp.json a la ruta absoluta del clon.
Autenticación API opcional
./scripts/setup-auth.shNo introduzcas contraseñas: el asistente acepta las cabeceras de una sesión ya iniciada. Si Codex captura la biblioteca desde Chrome, este paso no es necesario.
Desarrollo
uv sync
uv run ruff check .
uv run pytestLimitación de género
YouTube Music no entrega un campo de género por pista. search_music(..., genre="jazz") añade el
género a la consulta del catálogo, pero no intenta clasificar automáticamente cada favorito.
Licencia
MIT © 2026 Eduardo Arias Bravo.
Available Tools
7 toolsauth_statusA
Comprueba si la sesion local esta configurada; verify=True hace una llamada privada minima.
Inputs: verify.
export_liked_songsB
Exporta favoritos a CSV o JSON dentro de Documents/YouTube Music Exports.
Inputs: limit, format.
get_playlistA
Obtiene metadatos y canciones de una playlist por su identificador.
Inputs: playlist_id (required), limit.
list_library_playlistsB
Lista las playlists guardadas en la biblioteca de la cuenta autenticada.
Inputs: limit.
list_liked_songsA
Lista canciones marcadas con Me gusta y permite filtrarlas por texto, artista o album.
Inputs: album, limit, query, artist.
search_musicC
Busca en el catalogo por texto, genero y/o artista; el genero se incorpora a la consulta.
Inputs: genre, limit, query, artist, +1 more.
summarize_liked_libraryC
Resume favoritos por artistas, albumes, anos y pistas no disponibles.
Inputs: top, limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool has a clearly distinct purpose: authentication status, listing liked songs, listing playlists, fetching a specific playlist, searching, summarizing, and exporting. There is no meaningful overlap; even similar-sounding tools like list_liked_songs and summarize_liked_library serve different functions (enumeration vs. aggregation).
Most tools follow a consistent verb_noun pattern (list_, get_, search_, summarize_, export_). The exception is auth_status, which lacks a verb and disrupts the otherwise uniform style. This minor deviation prevents a perfect score but the pattern is still highly readable.
Seven tools is well within the ideal range for a library-oriented MCP server. Each tool addresses a core function (authentication, listing, searching, exporting, summarizing) without redundancy or bloat. The count feels appropriately scoped for the server's purpose.
The server covers the full lifecycle of interacting with a user's YouTube Music library: authenticate, list liked songs, list playlists, fetch playlist contents, search, summarize, and export. There are no obvious dead ends for typical workflows like browsing, analyzing, or exporting favorites. Minor operations like adding/removing likes are outside the apparent scope, so no gaps are evident.
Related MCP Connectors
Real-time YouTube transcripts, comments, channels & video search MCP. Local npx or hosted OAuth.
An MCP server that provides read access to your cloud storage providers, bank accounts and more.
Read-only MCP server exposing a user ORANO library to their own AI agent.
Unofficial YouTube MCP — wraps the YouTube Data API v3 (BYO API key)
Related MCP Servers
- AlicenseBqualityDmaintenanceLocal read-only MCP server for YouTube Data API v3 and YouTube Analytics API, enabling public video searches and OAuth-based private channel reads.9MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for YouTube Music that enables searching songs and artists, managing playlists, and authenticating via Google OAuth, using STDIO transport.MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that enables AI applications to search YouTube music videos and manage playlists via the YouTube Data API v3, with OAuth support for playlist and subscription management.3MIT
- AlicenseAqualityCmaintenanceMCP server for Spotify that enables searching, reading playlists, saved tracks, artist info, and recommendations, plus creating playlists and adding tracks, with no playback control.16MIT