YouTube MCP Server

MCP (Model Context Protocol) server to interact with YouTube: search videos, get transcripts, find trending content, and explore AI communities.

Features

• Search videos by keyword

• Get trending videos by region and category

• Fetch video transcripts/subtitles (no API key needed for transcripts)

• Get detailed video metadata

• Look up channel info and latest uploads

• Read video comments

• Discover and rank AI-focused communities by subscribers

Related MCP server: YouTube MCP Server

Prerequisites

• YouTube Data API v3 key — get one at https://console.cloud.google.com/apis/credentials

• Enable the YouTube Data API v3 in your Google Cloud project

Quick Start

cp .env.example .env
# Edit .env with your YOUTUBE_API_KEY

pip install -r requirements.txt
python server.py

Tools

Register with opencode

{
  "mcpServers": {
    "youtube": {
      "command": "python3",
      "args": ["/caminho/para/youtube-mcp/server.py"],
      "env": {
        "YOUTUBE_API_KEY": "sua_chave"
      }
    }
  }
}

How it works

Uses the YouTube Data API v3 for metadata, search, and comments, and youtube-transcript-api for subtitles (no extra auth needed).

Docker

This is a stdio server, so the container must keep stdin open (-i):

docker build -t youtube-mcp .
docker run -i --rm -e YOUTUBE_API_KEY="sua_chave" youtube-mcp

A HEALTHCHECK validates the MCP handshake on startup.

Tests

python -m pytest . -v