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.

Privacidad y arquitectura

El servidor tiene dos modos de lectura:

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

Licencia

MIT © 2026 Eduardo Arias Bravo.