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: YouTube MCP Server

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

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.