YouTube Insights MCP Server

A Model Context Protocol (MCP) server that enables insight extraction from YouTube videos, including subtitle parsing, keyword-based video discovery, and channel info retrieval.

Features

• Extract transcripts from YouTube videos (multi-language)
• Search videos by keyword and fetch metadata (views, likes, thumbnails, etc.)
• Retrieve channel info and latest videos from any YouTube video URL
• FastMCP-based server integration for easy deployment
• MCP Tools for seamless agent workflows

Example usecases

<details> <summary>Finding Trending Videos and Summarizing</summary> <img src="https://github.com/user-attachments/assets/60a97619-13cf-4aba-807e-0fad0a4f3b42" width="480"/> </details>

<details> <summary>Analyzing a Channel's Recent Performance</summary> <img src="https://github.com/user-attachments/assets/4f35a716-0c92-4368-8ba5-0b564613aae0" width="480"/> </details>

Installation

Installing via Smithery

To install youtubeinsights-mcp-server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @dabidstudio/youtubeinsights-mcp-server --client claude

Using uvx (recommended)

When using uvx, no specific installation is needed.

Add the following configuration to your MCP settings file (e.g., claude_desktop_config.json for Claude Desktop):

{
  "mcpServers": {
    "youtubeinsights": {
      "command": "uvx",
      "args": ["youtubeinsights-mcp-server"],
      "env": {
        "YOUTUBE_API_KEY": "your-api-key",
      }
    }
  }
}

Development Installation

1. Clone this repository

2. Install dependencies:

   uv venv
   

3. Copy .env.example to .env and fill in your youtube data api credentials

   {
     "mcpServers": {
       "youtubeinsights": {
         "command": "uv",
         "args": [
           "--directory",
           "path/to/youtubeinsights-mcp-server",
           "run",
           "youtubeinsights-mcp-server"
         ],
         "env": {
           "YOUTUBE_API_KEY": "your-api-key",
         }
       }
     }
   }
   

Available MCP Tools

• get_youtube_transcript: Extract full transcript (subtitles) from a YouTube video URL (supports ko, en)
• search_youtube_videos: Search for videos on YouTube by keyword and retrieve key metadata
• get_channel_info: Get channel metadata and recent uploads based on any YouTube video URL

Sample MCP Tool Descriptions

{
  "tool": "get_youtube_transcript",
  "description": "Extract subtitles from a given YouTube video URL."
}

{
  "tool": "search_youtube_videos",
  "description": "Search videos by keyword and return metadata including views, likes, and thumbnails."
}

{
  "tool": "get_channel_info",
  "description": "Retrieve channel info (title, subscriber count, latest uploads) based on a video URL."
}

License

This project is licensed under the MIT License. See the LICENSE file for details.