Youtube-Ultimate-Toolkit

Youtube-Ultimate-Toolkit MCP exposes a set of YouTube-focused tools via the MCP interface to let Claude access transcripts, metadata, comments, screenshots, and audio clips from YouTube videos. The primary tools are get_video (video metadata and transcript with optional search, timestamps, and time-range filtering), get_playlist (list videos in a playlist), get_comments (top comments with optional YouTube API key for authentication), get_screenshot (capture frames at specified timestamps), and get_audio (extract short audio clips for analysis). You can configure the MCP as a local (Claude Desktop) or remote (Claude Web UI) service, and then reference it in Claude’s MCP connector configuration. To use a locally running server, point Claude’s config to the local Node.js server path (as shown in the Quick Start example). For remote usage, you’ll need OAuth setup, a public URL, and HTTPS termination with a reverse proxy as described in the Remote Mode setup section. The tools can be invoked by asking Claude to fetch a video, a playlist, or specific data, for example: “get_video for URL from video, include transcripts with timestamps,” or “get_comments for a video with YouTube API key.” The tools support filtering and parameterization such as startTime, endTime, searchTerm for transcripts, limit for playlists, maxResults for comments, and timestamp or duration options for screenshots and audio. Remember to keep yt-dlp up to date to avoid transcript failures, since YouTube frequently changes their APIs.

Prerequisites:\n- Node.js 18+\n- yt-dlp (YouTube content fetcher)\n- ffmpeg (optional, for screenshots and audio)\n- YouTube API Key (optional, for comments)\n\nInstallation steps:\n1) Clone the repository and install dependencies:\nbash\ngit clone https://github.com/Comzee/Youtube-Ultimate-Toolkit-MCP.git\ncd Youtube-Ultimate-Toolkit-MCP\nnpm install\nnpm run build\n\n2) Run the server locally:\nbash\nnode dist/index.js\n\n3) Optional: Add the MCP server to Claude Desktop configuration:\njson\n{\n "mcpServers": {\n "youtube": {\n "command": "node",\n "args": ["/path/to/Youtube-Ultimate-Toolkit-MCP/dist/index.js"]\n }\n }\n}\n\n4) If you plan to use Remote Mode, follow the Remote Mode Setup steps (OAuth, HTTPS, and domain provisioning) provided in the README. Ensure you have the required environment variables set when running in remote mode.

Tips and common issues:\n- Node.js version: Ensure you’re on Node.js 18+ as required.\n- Prerequisites: Keep yt-dlp updated (pip3 install --upgrade yt-dlp) to accommodate YouTube changes.\n- ffmpeg is optional but required for get_screenshot and get_audio if you want those features.\n- YouTube API Key for get_comments is optional but required if you want to fetch real comments with like/reply metrics.\n- Remote mode requires HTTPS; use a reverse proxy (e.g., nginx) and configure OAuth credentials in .env.\n- If transcripts stop working after YouTube changes, update yt-dlp first and then restart the MCP server.\n- In remote mode, ensure you correctly expose the MCP at a public URL and configure the OAuth redirect URIs in the Google Cloud Console (or equivalent).