YouTube Watch Later MCP Server logo

YouTube Watch Later MCP Server

by rados10

This is a Model Context Protocol (MCP) server that allows you to retrieve URLs of videos added to a specified YouTube playlist within a configurable timeframe. It provides a simple tool to access your YouTube watch later list.

View on GitHub

Last updated: N/A

What is YouTube Watch Later MCP Server?

The YouTube Watch Later MCP Server is a tool that exposes a simple interface to retrieve the URLs of videos added to your YouTube watch later playlist within a specified number of days. It uses the Model Context Protocol (MCP) to integrate with applications like Claude, allowing you to easily access and utilize your watch later list.

How to use YouTube Watch Later MCP Server?

  1. Install the server using either Smithery or manual installation.
  2. Create a Google Cloud Project and enable the YouTube Data API v3.
  3. Obtain OAuth 2.0 credentials (Client ID and Client Secret).
  4. Use the provided script to get a refresh token.
  5. Configure your MCP settings file with the server's command, arguments, and environment variables (including your OAuth credentials).
  6. Use the get_watch_later_urls tool with an optional daysBack parameter to retrieve the URLs of videos added within the specified timeframe.

Key features of YouTube Watch Later MCP Server

  • Retrieves video URLs from a YouTube watch later playlist

  • Configurable timeframe for retrieving videos

  • Simple interface that returns only video URLs

  • OAuth2 authentication for secure access to your YouTube data

Use cases of YouTube Watch Later MCP Server

  • Summarizing recently added videos to your watch later list

  • Creating a playlist of videos to watch based on a specific topic

  • Integrating your watch later list with other applications

  • Generating a list of video URLs for documentation or sharing

FAQ from YouTube Watch Later MCP Server

How do I install the server?

You can install the server either automatically via Smithery or manually by cloning the repository, installing dependencies, and building the project.

How do I get a refresh token?

You need to create a Google Cloud Project, enable the YouTube Data API v3, obtain OAuth 2.0 credentials, and then run the provided get-refresh-token.js script.

Where do I configure the MCP settings?

The MCP settings file location depends on the application you are using. For VSCode (Claude Dev Extension), it's typically located at ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json. For Claude Desktop App, it's at ~/Library/Application Support/Claude/claude_desktop_config.json.

How do I use the server?

The server provides a single tool get_watch_later_urls that accepts an optional daysBack parameter. You can specify the number of days back to retrieve videos added within that timeframe.

When do I need to get a new refresh token?

You only need to get a new refresh token if you revoke the application's access in your Google Account settings, reset your Google account's security settings, or the token becomes invalid for any other reason.