Skip to main content

YouTube MCP Server for video analysis with Gemini AI

Project description

YouTube MCP

smithery badge

A Model Context Protocol (MCP) server for YouTube video analysis, providing tools to get transcripts, summarize content, and query videos using Gemini AI.

Features

  • 📝 Transcript Extraction: Get detailed transcripts from YouTube videos
  • 📊 Video Summarization: Generate concise summaries using Gemini AI
  • Natural Language Queries: Ask questions about video content
  • 🔍 YouTube Search: Find videos matching specific queries
  • 💬 Comment Analysis: Retrieve and analyze video comments

Requirements

  • Python 3.9+
  • Google Gemini API key
  • YouTube Data API key

Running Locally

Installing via Smithery

To install youtube-mcp for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @Prajwal-ak-0/youtube-mcp --client claude

Option 1: Install directly from smithery

smithery badge

Option 2: Local setup

  1. Clone the repository:

    git clone https://github.com/Prajwal-ak-0/youtube-mcp
    cd youtube-mcp
    
  2. Create a virtual environment and install dependencies:

    python -m venv .venv
    source .venv/bin/activate  # On Windows: .venv\Scripts\activate
    pip install -e .
    
  3. Create a .env file with your API keys:

    GEMINI_API_KEY=your_gemini_api_key
    YOUTUBE_API_KEY=your_youtube_api_key
    
  4. Run MCP Server

    mcp dev main.py
    

    Navigate to Stdio

    OR

  5. Go cursor or windsurf configure with this json content:

    {
      "youtube": {
        "command": "uv",
        "args": [
          "--directory",
          "/absolute/path/to/youtube-mcp",
          "run",
          "main.py",
          "--transport",
          "stdio",
          "--debug"
        ]
      }
    }
    

Available Tools

  • youtube/get-transcript: Get video transcript
  • youtube/summarize: Generate a video summary
  • youtube/query: Answer questions about a video
  • youtube/search: Search for YouTube videos
  • youtube/get-comments: Retrieve video comments
  • youtube/get-likes: Get video like count

Contributing

Contributions welcome! Please feel free to submit a Pull Request.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

iflow_mcp_youtube_mcp-0.1.0.tar.gz (2.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

iflow_mcp_youtube_mcp-0.1.0-py3-none-any.whl (2.7 kB view details)

Uploaded Python 3

File details

Details for the file iflow_mcp_youtube_mcp-0.1.0.tar.gz.

File metadata

File hashes

Hashes for iflow_mcp_youtube_mcp-0.1.0.tar.gz
Algorithm Hash digest
SHA256 302dcfc402dcc19e64090b62a0d0aee4b0c2e2162db02cb9df5a1154b0b7d027
MD5 af2146e7197892d07ac180d1a9a16a53
BLAKE2b-256 c035d670116d8082dc153f1d71a5e5f1423c622ef0f920dc5b892aa05e8db7ec

See more details on using hashes here.

File details

Details for the file iflow_mcp_youtube_mcp-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for iflow_mcp_youtube_mcp-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 47fcf95d6e9cc9fbc5c03e62e6fc402d1ef3a347caf9f81bde7859efeb222695
MD5 571bdbaac5ac2a7eb3ca5b0eb81cdf32
BLAKE2b-256 ab38c138546727dc16d50494c3a75c2ab728803ce3deaaf3e350f353b12551fe

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page