YouTube Watch Later MCP Server

A Model Context Protocol (MCP) server that provides access to a custom YouTube playlist. The server exposes a simple tool to retrieve URLs of videos added to the specified playlist within a specified timeframe.

Features

• Get URLs of videos added to a custom playlist within a configurable number of days

• Simple interface that returns just the video URLs

• OAuth2 authentication for secure access to your YouTube data

Related MCP server: MCP YouTube Server

Installation

Installing via Smithery

To install YouTube Watch Later for Claude Desktop automatically via Smithery:

Manual Installation

1. Clone this repository:

2. Install dependencies:

3. Build the project:

Setup

1. Create Google Cloud Project

1. Go to Google Cloud Console

2. Create a new project or select an existing one

3. Enable the YouTube Data API v3

4. Go to Credentials → Create Credentials → OAuth 2.0 Client ID

5. Set Application Type to "Web application"

6. Add "http://localhost:3000/oauth2callback" to Authorized redirect URIs

7. Copy your Client ID and Client Secret

2. Get Refresh Token

Run the provided script with your Google Cloud credentials:

The script will:

• Open your default browser to the Google authorization page

• Ask you to sign in and authorize the application

• Display your refresh token in the terminal

3. Configure MCP Settings

Add the server configuration to your MCP settings file:

For VSCode (Claude Dev Extension): ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

For Claude Desktop App: ~/Library/Application Support/Claude/claude_desktop_config.json

Usage

The server provides a single tool get_watch_later_urls that accepts an optional daysBack parameter:

The server will return an array of YouTube URLs for the matching videos:

Token Refresh

The refresh token doesn't expire unless you explicitly revoke access. You only need to get a new one if you:

• Revoke the application's access in your Google Account settings

• Reset your Google account's security settings

• The token becomes invalid for any other reason

To get a new refresh token, simply run the get-refresh-token.js script again as described in the Setup section.

Development

The server is built with:

• TypeScript

• @modelcontextprotocol/sdk

• googleapis (YouTube Data API v3)

To modify the server:

1. Make your changes in src/index.ts

2. Run npm run build to compile

3. Restart the MCP server to apply changes