YouTube Watch Later MCP Server

YouTube Watch Later MCP サーバー

カスタム YouTube プレイリストにアクセスできる Model Context Protocol（MCP）サーバーです。指定した期間内に指定のプレイリストへ追加された動画の URL を取得する、シンプルなツールを提供します。

機能

• 設定可能な日数の範囲内にカスタムプレイリストへ追加された動画の URL を取得
• 動画の URL のみを返すシンプルなインターフェース
• YouTube データへ安全にアクセスするための OAuth2 認証

インストール

Smithery 経由でのインストール

Smithery 経由で YouTube Watch Later を Claude Desktop に自動でインストールするには：

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

手動インストール

1. このリポジトリをクローンします：

git clone https://github.com/rados10/youtube-watchlater-mcp.git
cd youtube-watchlater

2. 依存関係をインストールします：

npm install

3. プロジェクトをビルドします：

npm run build

セットアップ

1. Google Cloud プロジェクトを作成する

1. Google Cloud Console にアクセスします
2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択します
3. YouTube Data API v3 を有効にします
4. 認証情報 → 認証情報を作成 → OAuth 2.0 クライアント ID に移動します
5. アプリケーションの種類を「ウェブアプリケーション」に設定します
6. 承認済みのリダイレクト URI に「http://localhost:3000/oauth2callback」を追加します
7. クライアント ID とクライアントシークレットをコピーします

2. 更新トークンを取得する

Google Cloud の認証情報を使って、付属のスクリプトを実行します：

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

スクリプトは次の処理を行います：

• Google の認証ページをデフォルトのブラウザーで開きます
• サインインしてアプリケーションを承認するよう求めます
• ターミナルに更新トークンを表示します

3. MCP 設定を構成する

MCP 設定ファイルにサーバーの構成を追加します：

VSCode（Claude Dev Extension）の場合： ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

Claude Desktop App の場合： ~/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"
      }
    }
  }
}

使用方法

サーバーは、オプションの daysBack パラメーターを受け取る単一のツール get_watch_later_urls を提供します：

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

// Get videos added in the last week
{ "daysBack": 7 }

サーバーは、条件に一致する動画の YouTube URL の配列を返します：

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

トークンの更新

更新トークンは、明示的にアクセスを取り消さない限り有効期限がありません。次の場合にのみ、新しいトークンを取得する必要があります：

• Google アカウントの設定でアプリケーションのアクセスを取り消した場合
• Google アカウントのセキュリティ設定をリセットした場合
• その他の理由でトークンが無効になった場合

新しい更新トークンを取得するには、「セットアップ」セクションの説明に従って get-refresh-token.js スクリプトをもう一度実行します。

開発

このサーバーは次の技術を使って構築されています：

• TypeScript
• @modelcontextprotocol/sdk
• googleapis（YouTube Data API v3）

サーバーを変更するには：

1. src/index.ts を編集します
2. npm run build を実行してコンパイルします
3. MCP サーバーを再起動して変更を適用します