YouTube Watch Later MCP Server

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Uses Google Cloud OAuth 2.0 for authentication to securely access YouTube data

  • Allows access to a user's YouTube playlists to retrieve URLs of videos added to a specified playlist within a configurable timeframe

Servidor MCP de YouTube Ver más tarde

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona acceso a una lista de reproducción personalizada de YouTube. El servidor expone una herramienta sencilla para recuperar las URL de los vídeos añadidos a la lista de reproducción especificada en un periodo de tiempo determinado.

Características

  • Obtenga las URL de los videos agregados a una lista de reproducción personalizada dentro de una cantidad de días configurable
  • Interfaz sencilla que devuelve únicamente las URL de los vídeos
  • Autenticación OAuth2 para un acceso seguro a tus datos de YouTube

Instalación

Instalación mediante herrería

Para instalar YouTube Watch Later para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install youtube-watchlater --client claude

Instalación manual

  1. Clonar este repositorio:
git clone https://github.com/rados10/youtube-watchlater-mcp.git cd youtube-watchlater
  1. Instalar dependencias:
npm install
  1. Construir el proyecto:
npm run build

Configuración

1. Crear un proyecto de Google Cloud

  1. Ir a la consola de Google Cloud
  2. Crea un nuevo proyecto o selecciona uno existente
  3. Habilitar la API de datos de YouTube v3
  4. Vaya a Credenciales → Crear credenciales → ID de cliente OAuth 2.0
  5. Establezca el tipo de aplicación en "Aplicación web"
  6. Agregue " http://localhost:3000/oauth2callback " a las URI de redireccionamiento autorizadas
  7. Copia tu ID de cliente y secreto de cliente

2. Obtener token de actualización

Ejecute el script proporcionado con sus credenciales de Google Cloud:

OAUTH_CLIENT_ID="your_client_id" OAUTH_CLIENT_SECRET="your_client_secret" node get-refresh-token.js

El guión hará lo siguiente:

  • Abra su navegador predeterminado en la página de autorización de Google
  • Le pediremos que inicie sesión y autorice la aplicación.
  • Muestra tu token de actualización en la terminal

3. Configurar los ajustes de MCP

Agregue la configuración del servidor a su archivo de configuración de MCP:

Para VSCode (extensión de Claude Dev): ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

Para la aplicación de escritorio Claude: ~/Library/Application Support/Claude/claude_desktop_config.json

{ "mcpServers": { "youtube-watchlater": { "command": "node", "args": ["/path/to/youtube-watchlater/build/index.js"], "env": { "OAUTH_CLIENT_ID": "your_client_id", "OAUTH_CLIENT_SECRET": "your_client_secret", "OAUTH_REFRESH_TOKEN": "your_refresh_token" } } } }

Uso

El servidor proporciona una única herramienta get_watch_later_urls que acepta un parámetro daysBack opcional:

// Get videos added in the last day (default) { "daysBack": 1 } // Get videos added in the last week { "daysBack": 7 }

El servidor devolverá una matriz de URL de YouTube para los videos coincidentes:

[ "https://youtube.com/watch?v=video1", "https://youtube.com/watch?v=video2", ... ]

Actualización de token

El token de actualización no caduca a menos que revoques el acceso explícitamente. Solo necesitas obtener uno nuevo si:

  • Revocar el acceso a la aplicación en la configuración de tu cuenta de Google
  • Restablecer la configuración de seguridad de su cuenta de Google
  • El token deja de ser válido por cualquier otro motivo

Para obtener un nuevo token de actualización, simplemente ejecute el script get-refresh-token.js nuevamente como se describe en la sección Configuración.

Desarrollo

El servidor está construido con:

  • Mecanografiado
  • @modelcontextprotocol/sdk
  • googleapis (API de datos de YouTube v3)

Para modificar el servidor:

  1. Realice sus cambios en src/index.ts
  2. Ejecute npm run build para compilar
  3. Reinicie el servidor MCP para aplicar los cambios
-
security - not tested
A
license - permissive license
-
quality - not tested

Permite el acceso seguro a tu lista de reproducción Ver más tarde de YouTube, lo que permite recuperar las URL de videos agregados dentro de un período de tiempo específico a través de una interfaz simple que utiliza la autenticación OAuth2.

  1. Features
    1. Installation
      1. Installing via Smithery
      2. Manual Installation
    2. Setup
      1. 1. Create Google Cloud Project
      2. 2. Get Refresh Token
      3. 3. Configure MCP Settings
    3. Usage
      1. Token Refresh
        1. Development
          ID: q4mffr1nfl