Youtube MCP Server

MCP stdio server for analyzing YouTube videos with Google Gemini

Local serverstdio

What is the Youtube MCP Server?

MCP stdio server for analyzing YouTube videos with Google Gemini

What it needs from you

  • Node.js 20 or newer. - A Gemini API key. - Optional: a YouTube Data API key for metadata lookup. - Optional for best long-video support: yt-dlp and ffmpeg.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
get_youtube_analyzer_capabilitiesinspects local support for long-video strategies.
get_youtube_video_metadatafetches normalized public YouTube metadata.
get_youtube_video_frameextracts a high-resolution JPEG frame at a timestamp, with optional Gemini timestamp refinement before local extraction.
analyze_youtube_videoanalyzes short videos or bounded clip windows.
analyze_youtube_video_audioanalyzes speech-focused videos using audio-first instructions.
analyze_long_youtube_videoanalyzes long videos or VODs as a required MCP task.
start_long_youtube_analysisstarts a background long-video job and returns a jobId.
get_long_youtube_analysis_statuspolls a background long-video job.
get_long_youtube_analysis_resultfetches a completed background long-video job result.
cancel_long_youtube_analysiscancels a background long-video job.
continue_long_video_analysisasks follow-up questions for a previous long-video session as a required MCP task.

How to install the Youtube MCP Server

{
  "mcpServers": {
    "youtube-analyzer": {
      "command": "npx",
      "args": ["-y", "@ludylops/youtube-video-analyzer-mcp"],
      "env": {
        "GEMINI_API_KEY": "your_gemini_key_here",
        "YOUTUBE_API_KEY": "optional_youtube_key_here"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

  • Node.js 20 or newer. - A Gemini API key. - Optional: a YouTube Data API key for metadata lookup. - Optional for best long-video support: yt-dlp and ffmpeg.
VariableDescriptionRequired
GEMINI_API_KEYCredential the server authenticates with.Yes
YOUTUBE_API_KEYCredential the server authenticates with.Yes
YT_DLP_PATHFilesystem location the server is allowed to use.Optional

Example prompts to try

  • “Use Youtube to get youtube analyzer capabilities.”
  • “Use Youtube to get youtube video metadata.”
  • “Use Youtube to get youtube video frame.”

Frequently asked questions

MCP stdio server for analyzing YouTube videos with Google Gemini Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.