YouTube MCP Server

Model Context Protocol (MCP) server for YouTube Data API v3. Provides tools for searching videos, channels, playlists, getting trending content, video details, comments, and more.

Features

• Video Search - Search YouTube videos with advanced filters (duration, definition, region, date range, etc.)

• Channel Search - Find channels by query

• Video Details - Get comprehensive video information (statistics, content details, topics, etc.)

• Channel Details - Get channel statistics, branding, topics, and more

• Trending Videos - Get most popular videos by region and category

• Video Categories - Browse available video categories

• Channel Videos - Get recent uploads from a specific channel

• Playlist Videos - Get videos from any playlist

• Playlist Search - Search for playlists

• Video Comments - Get comments on videos

• Channel by Handle - Look up channels by @username

Related MCP server: yutu

Installation

cd /opt/data/mcp-servers/youtube-mcp
pip install -e .

Or with uv:

uv pip install -e /opt/data/mcp-servers/youtube-mcp

Configuration

Requires a YouTube Data API v3 key. Get one from Google Cloud Console.

Set the environment variable:

export YOUTUBE_API_KEY="your_api_key_here"

Usage with Hermes Agent

Add to your ~/.hermes/config.yaml:

mcp_servers:
  youtube:
    command: "uvx"
    args: ["youtube-mcp"]
    env:
      YOUTUBE_API_KEY: "your_api_key_here"
    timeout: 120
    connect_timeout: 60

Then restart Hermes Agent. The tools will be available as mcp_youtube_*.

Available Tools

Example Queries

• "Search for videos about AI news from the last week"

• "Get trending videos in Brazil (BR)"

• "Find channels about programming tutorials"

• "Get details for video dQw4w9WgXcQ"

• "Get comments on a viral video"

• "Find playlists about machine learning"

Development

# Install dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

License

MIT