Leverages Google's Gemini API to perform AI-powered analysis, summarization, and question-answering for YouTube video content.
Provides tools for analyzing YouTube videos directly via their URLs, enabling users to generate summaries at various detail levels and ask specific questions about the video's content.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@yt-analysis-mcp Can you give me a detailed summary of https://www.youtube.com/watch?v=dQw4w9WgXcQ?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
An MCP server that analyzes YouTube videos using Google's Gemini API. Pass in a YouTube URL to get summaries or ask questions about the video content.
Summarize videos - Get brief, medium, or detailed summaries with timestamps
Ask questions - Ask specific questions about video content
Direct URL support - No video downloading required; Gemini analyzes YouTube URLs directly
Related MCP server: yt-mcp
git clone https://github.com/yourusername/yt-analysis-mcp.git
cd yt-analysis-mcp
pnpm install
pnpm buildSet your Gemini API key:
export GEMINI_API_KEY=your-api-keyGet an API key from Google AI Studio.
claude mcp add -s user -e GEMINI_API_KEY=your-key yt-analysis -- node /path/to/yt-analysis-mcp/dist/index.jsAdd to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"yt-analysis": {
"command": "node",
"args": ["/path/to/yt-analysis-mcp/dist/index.js"],
"env": {
"GEMINI_API_KEY": "your-key"
}
}
}
}summarize_videoSummarize a YouTube video's content.
Parameter | Type | Required | Description |
| string | Yes | Full YouTube URL |
| string | No |
|
ask_about_videoAsk a specific question about a YouTube video's content.
Parameter | Type | Required | Description |
| string | Yes | Full YouTube URL |
| string | Yes | Your question about the video |
https://www.youtube.com/watch?v=VIDEO_ID
https://youtu.be/VIDEO_ID
https://youtube.com/shorts/VIDEO_ID
# Run in development mode
pnpm dev
# Run tests
pnpm test
# Build
pnpm buildMIT
Ask a specific question about a YouTube video's content. Returns an answer based on the video.
Inputs: youtube_url (required), question (required).
Extract frames from a YouTube video at specific timestamps you provide. Use this when you already know the exact timestamps you want (e.g., from get_video_timestamps or video summary).
Inputs: youtube_url (required), timestamps (required), output_dir, resolution.
Extract key screenshots from a YouTube video at important moments. Uses AI to identify visually significant timestamps, then extracts frames. Returns both base64 images and optionally saves to disk.
Inputs: youtube_url (required), count, output_dir, focus, +1 more.
Preview mode: Use AI to identify important moments in a YouTube video and return their timestamps WITHOUT extracting frames. Use this to preview what timestamps would be selected before committing to extraction.
Inputs: youtube_url (required), count, focus.
Summarize a YouTube video's content. Returns a text summary based on the specified detail level.
Inputs: youtube_url (required), detail_level.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 5 tools
Each tool has a clearly distinct purpose with no ambiguity: ask_about_video answers questions about content, extract_frames extracts frames at user-provided timestamps, extract_screenshots uses AI to find and extract key frames, get_video_timestamps previews AI-identified timestamps, and summarize_video provides text summaries. The descriptions explicitly differentiate their use cases, such as distinguishing between extract_frames (manual timestamps) and extract_screenshots (AI-selected timestamps).
All tool names follow a consistent verb_noun pattern with underscores, using clear action verbs like ask_about, extract, get, and summarize paired with descriptive nouns like video, frames, screenshots, and timestamps. There are no deviations in style or convention, making the set predictable and easy to understand at a glance.
With 5 tools, the count is well-scoped for the YouTube analysis domain, covering core workflows like content querying, frame extraction (both manual and AI-driven), timestamp previewing, and summarization. Each tool earns its place without redundancy, and the number is manageable for agents to navigate effectively.
The tool set provides strong coverage for video analysis, including content understanding, visual extraction, and summarization, with no dead ends. A minor gap exists in lacking direct video metadata retrieval (e.g., title, duration, uploader), but agents can work around this by using existing tools like ask_about_video or summarize_video for such information.
Summarize YouTube videos, playlists and channels, ask about a video, and get key moments.
YouTube for AI agents: transcripts, comments, video stats, channel monitor, Shorts captions.
Search YouTube videos, read transcripts and get public video information in your AI assistant.
Gemini watches public YouTube videos and returns a timestamped brief or answers to your questions.
