YouTube Music MCP

Python 3.11+ License: MIT

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.

Privacidad y arquitectura

El servidor tiene dos modos de lectura:

live_api: usa una sesión local de ytmusicapi.
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.json

El MCP no expone herramientas que modifiquen la cuenta.

Herramientas MCP

Herramienta	Descripción
`auth_status`	Comprueba la fuente de datos disponible.
`list_liked_songs`	Lista y filtra canciones favoritas.
`list_library_playlists`	Lista playlists guardadas.
`get_playlist`	Obtiene canciones de una playlist.
`search_music`	Busca en el catálogo por texto, artista o género.
`summarize_liked_library`	Resume artistas, álbumes y años.
`export_liked_songs`	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.sh

El último comando adapta .mcp.json a la ruta absoluta del clon.

Autenticación API opcional

./scripts/setup-auth.sh

No 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 pytest

Limitació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.