Youtube MCP

🚀 YouTube MCP

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

🚀 Quick Start

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

✨ Features

• 📝 Subtitle Extraction: Retrieve detailed subtitles from YouTube videos.
• 📊 Video Summarization: Generate concise video summaries using Gemini AI.
• ❓ Natural Language Query: Ask questions about the video content.
• 🔍 YouTube Search: Find videos that match specific queries.
• 💬 Comment Analysis: Retrieve and analyze video comments.

📦 Installation

Prerequisites

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

Running Locally

Install via Smithery

To automatically install youtube - mcp from Claude Desktop, use Smithery:

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

Option 1: Install directly from smithery

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 containing API keys:

   GEMINI_API_KEY=your_gemini_api_key
   YOUTUBE_API_KEY=your_youtube_api_key
   

4. Run the MCP server

   mcp dev main.py
   

   Open Stdio to access.

   Or

5. Configure Go cursor or windsurf with the following JSON content:

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

💻 Usage Examples

Available Tools

• youtube/get-transcript: Get video subtitles.
• youtube/summarize: Generate a video summary.
• youtube/query: Ask questions about the video content.
• youtube/search: Search for YouTube videos.
• youtube/get-comments: Retrieve video comments.
• youtube/get-likes: Get the number of video likes.

🤝 Contribution

Contributions are welcome! Feel free to submit a Pull Request.