Log inSubmit server
Youtube Video Analyzer logo

Youtube Video Analyzer

Analyzes public YouTube videos with Gemini, including metadata, frames, speech, clips, long VODs, and follow-up sessions.

InstallRepository
Full README Compare alternatives Embed widget Claim this listing

Install Youtube Video Analyzer

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "youtube-video-analyzer": {
      "command": "npx",
      "args": [
        "-y",
        "@ludylops/youtube-video-analyzer-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 3 tools correctly (7d ago).

Overview

The youtube-video-analyzer MCP server connects an MCP-compatible client to Google Gemini for analyzing public YouTube videos. It runs over stdio and provides tools for metadata, video frames, short clips, speech-focused analysis, long-video workflows, background jobs, and follow-up questions. Use it when an agent needs structured or conversational insight from accessible YouTube content, provided Gemini access and any required local media tools are available.

Use cases

  • Summarize a public YouTube video
  • Extract a frame at a specific timestamp
  • Analyze speech in a video
  • Process a long VOD asynchronously
  • Ask follow-up questions about a long video

Key features

  • Gemini-based YouTube video analysis
  • Normalized public video metadata
  • Timestamped JPEG frame extraction
  • Speech-focused audio analysis
  • Long-video tasks and background jobs
  • Reusable long-video follow-up sessions

Tools3

What Youtube Video Analyzer lets your agent do. Expand a tool for its parameters.

Verified live~566 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

4/4 checks healthy over the last 35d

What it can do

From the 3 tools this server returned when we ran it.

Makes network requests · 2Read-only tools · 3
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceNot published
Package age208 days
Maintainers1

Observed 2026-10-16 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 13d ago via OSV.dev · @ludylops/youtube-video-analyzer-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars5Stargazers on the source repository.
npm downloads148Package downloads in the last 30 days.
Last commit5mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed3Callable tools this server registers over MCP.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How Youtube Video Analyzer works

What youtube-video-analyzer MCP server does

The youtube-video-analyzer MCP server exposes Google Gemini-based analysis for public YouTube videos through MCP stdio. It can summarize or inspect short videos, analyze bounded clip windows, focus on spoken content, retrieve normalized public metadata, and extract a high-resolution JPEG frame at a requested timestamp.

Long videos and VODs have two supported workflows. MCP task-capable clients can use the native long-video analysis and follow-up tools. Clients with fixed synchronous timeouts can start a background job, poll its status, retrieve the result, or cancel it. Completed long-video work may produce a reusable session for follow-up questions.

The server can return structured JSON when a custom response schema is supplied. It is intended for public YouTube content; access restrictions imposed by YouTube or Gemini can prevent analysis.

How it works

Analysis requests send the YouTube URL, prompts, and relevant media or derived chunks to Google Gemini. For long videos, the server first exposes local capability information so the client can select an appropriate strategy.

When yt-dlp, ffmpeg, and a writable temporary directory are available, the long-video workflow can download temporary media and use an uploaded Gemini file session. The url_chunks strategy avoids local media downloads but can require additional Gemini calls. Short-video analysis and bounded windows are available through analyze_youtube_video, while analyze_youtube_video_audio supplies audio-first instructions for speech-focused material.

Frame extraction uses yt-dlp and ffmpeg to download a small, temporary high-quality window and return an exact JPEG frame. If timestamp refinement is requested, Gemini selects the timestamp; it does not generate the image pixels.

Setup and configuration

The youtube-video-analyzer MCP server requires Node.js 20 or newer and a Gemini API key. Add the published npm package to an MCP client's configuration with npx, or install it globally and run the included setup command. A YouTube Data API key is optional overall but required by get_youtube_video_metadata.

The main environment variables are GEMINI_API_KEY, YOUTUBE_API_KEY, GEMINI_MODEL, YT_DLP_PATH, and MCP_LOG_LEVEL. The repository also supports local development with npm install, npm run build, npm test, and npm start.

For best long-video support, install yt-dlp and ffmpeg. If those tools are unavailable, use URL chunking or analyze a shorter bounded window instead.

Tools and capabilities

Available MCP tools include:

  • Inspecting local support for long-video strategies.
  • Fetching normalized public YouTube metadata.
  • Extracting timestamped JPEG frames, with optional timestamp refinement.
  • Analyzing short videos, bounded clips, or speech-focused content.
  • Running native long-video tasks or compatibility background jobs.
  • Polling, retrieving, and cancelling long-video jobs.
  • Continuing a previous long-video session with follow-up questions.

The youtube-video-analyzer MCP server is a fit for agents that need video summaries, timestamped observations, spoken-content analysis, metadata lookup, or question answering over a previously analyzed long video.

Limitations and notes

The youtube-video-analyzer MCP server sends requested URLs, prompts, media, or derived chunks to Google Gemini. With uploaded-file processing, local tools may first download temporary media. URL chunking reduces local downloads but may increase the number of Gemini requests.

Private, deleted, age-restricted, member-only, DRM-protected, or region-blocked videos may fail depending on YouTube and Gemini access. Long-video native tools require MCP task execution; use the background-job sequence when the client supports only synchronous calls with a fixed timeout. Users must comply with applicable YouTube and Gemini terms, copyright requirements, and local law.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Youtube Video Analyzer

youtube-video-analyzer is an MCP server that connects MCP-compatible clients to Google Gemini for analyzing public YouTube videos. Its main tools retrieve metadata, extract timestamped frames, analyze short or speech-focused videos, process long videos through tasks or background jobs, and continue conversations about reusable long-video sessions.

Install it through an MCP client with npx using `@ludylops/youtube-video-analyzer-mcp`, or install it globally with npm and run `youtube-video-analyzer-mcp setup`. Configure `GEMINI_API_KEY`; add `YOUTUBE_API_KEY` only if metadata lookup is needed.

Yes, it supports long videos and VODs through native MCP tasks or compatibility background jobs. Call the capabilities tool first, then use the native workflow when tasks are supported or start, poll, and retrieve a background job when the client has fixed synchronous timeouts.

The best long-video support uses `yt-dlp`, `ffmpeg`, and a writable temporary directory. If those tools are unavailable, use the `url_chunks` strategy, which avoids local media downloads but may require more Gemini calls.

Related MCP servers

All in Multimedia Process All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewYoutube Video Analyzer AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/youtube-video-analyzer?style=directory)](https://allmcps.com/mcp/youtube-video-analyzer)
HTML Embed
<a href="https://allmcps.com/mcp/youtube-video-analyzer"><img src="https://allmcps.com/api/badge/youtube-video-analyzer?style=directory" alt="Youtube Video Analyzer on AllMCPs" /></a>