Skip to main content
Glama
YouTube Insights MCP Server

YouTube Insights MCP Server

YouTube Insights MCP Server

An MCP (Model Context Protocol) server that extracts valuable insights from YouTube videos including transcripts, metadata, and summaries.

Features

  • Extract Transcripts: Get full video transcripts in multiple languages

  • Video Metadata: Retrieve title, author, thumbnail, and other metadata

  • Comprehensive Insights: Combined transcript, metadata, and auto-generated summaries

  • Multiple URL Formats: Supports youtube.com, youtu.be, shorts, and direct video IDs

Related MCP server: YouTube Content Extractor MCP

Installation

# Install dependencies
uv sync

Usage

Running the Server

python main.py

Available Tools

1. get_youtube_transcript

Extracts the full transcript from a YouTube video.

Parameters:

  • url (required): YouTube video URL or video ID

  • languages (optional): Array of preferred language codes (default: ["en"])

Example:

{
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "languages": ["en", "es"]
}

2. get_youtube_metadata

Gets metadata for a YouTube video.

Parameters:

  • url (required): YouTube video URL or video ID

Example:

{
  "url": "https://youtu.be/dQw4w9WgXcQ"
}

3. get_youtube_insights

Gets comprehensive insights including transcript, metadata, and summary.

Parameters:

  • url (required): YouTube video URL or video ID

  • languages (optional): Array of preferred language codes (default: ["en"])

  • summary_sentences (optional): Number of sentences for summary (default: 5)

Example:

{
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "languages": ["en"],
  "summary_sentences": 5
}

Supported URL Formats

  • https://www.youtube.com/watch?v=VIDEO_ID

  • https://youtu.be/VIDEO_ID

  • https://www.youtube.com/embed/VIDEO_ID

  • https://www.youtube.com/shorts/VIDEO_ID

  • Direct video ID: VIDEO_ID

Configuration for Claude Desktop

Add to your Claude Desktop config file:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "youtube-insights": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\Users\\TejasBorate\\Desktop\\Youtube-Video-Insights\\youtube_insights_mcp",
        "run",
        "python",
        "main.py"
      ]
    }
  }
}

Requirements

  • Python 3.10+

  • mcp

  • youtube-transcript-api

  • requests

Error Handling

The server handles various error cases:

  • Transcripts disabled for video

  • No transcript available

  • Video unavailable

  • Invalid URL format

  • Network errors

All errors are returned in a structured JSON format with descriptive messages.

Available Tools

3 tools
get_youtube_insightsC

Get comprehensive insights from a YouTube video including transcript, metadata, and a brief summary.

Inputs: url (required), languages, summary_sentences.

get_youtube_metadataB

Get metadata for a YouTube video including title, author, and thumbnail.

Inputs: url (required).

get_youtube_transcriptA

Extract the full transcript from a YouTube video. Supports various YouTube URL formats or direct video IDs.

Inputs: url (required), languages.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 3 tools

    Disambiguation2/5

    The tools have overlapping purposes, as get_youtube_insights includes metadata and transcript, making it ambiguous when to choose get_youtube_metadata or get_youtube_transcript instead. This overlap can lead to misselection, as agents might use the comprehensive tool unnecessarily or struggle to pick the right specialized one.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern with 'get_youtube_' prefix, using snake_case uniformly. This predictability makes it easy for agents to understand and navigate the tool set without confusion.

    Tool Count3/5

    With only 3 tools, the set feels thin for a 'YouTube Insights' server, as it lacks operations like search, list, or update capabilities that might be expected for broader video analysis. However, it covers basic retrieval functions, making it borderline appropriate but limited in scope.

    Completeness2/5

    There are significant gaps in the tool surface for a YouTube insights domain, such as no search tools for finding videos, no playlist or channel operations, and no update or deletion capabilities. The tools only provide read-only access to individual videos, which is insufficient for comprehensive insights workflows.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      B
      maintenance
      An MCP server that enables the extraction of transcripts and detailed metadata from YouTube videos. It allows users to retrieve video information like titles and descriptions, as well as transcripts with optional timestamps and language selection.
      2
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Extracts YouTube video metadata, titles, and descriptions along with transcripts generated from subtitles or OpenAI Whisper speech-to-text. This server enables users to retrieve and analyze detailed video content directly within MCP-compatible environments.
      1
      11 npm
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      MCP server that fetches YouTube video transcripts and optionally summarizes them. Supports multiple transcript formats (text, JSON, SRT, WebVTT), multi-language retrieval, and flexible YouTube URL parsing.
      6
      49 PyPI
      6
      MIT