aihenryai/mcp-youtube-analytics

YouTube MCP Server

Model Context Protocol server for YouTube - Provides AI assistants with access to YouTube data for analysis.

Features

• 📝 Video Transcripts - Extract subtitles and captions in multiple languages
• 📊 Channel Analytics - Get channel statistics and performance data
• 📹 Video Analytics - Detailed video metrics and engagement data
• 💬 Comments - Fetch and analyze video comments
• 🏷️ Metadata - Video descriptions, tags, thumbnails, and more
• 🔍 Search - Find videos by keywords and filters

Installation

Prerequisites

• Python 3.12 or higher
• YouTube Data API v3 key (Get one here)

Local Installation

# Clone the repository
git clone https://github.com/aihenryai/mcp-youtube-analytics.git
cd mcp-youtube-analytics

# Install dependencies
pip install -e .

# Create .env file with your API key
echo "YOUTUBE_API_KEY=your_api_key_here" > .env

Configuration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "youtube": {
      "command": "python",
      "args": ["-m", "youtube_mcp_server"],
      "env": {
        "YOUTUBE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Available Tools

1. get_transcript

Extract video transcripts/subtitles

• video_url: YouTube video URL or ID
• language: Language code (optional, e.g., 'en', 'he', 'ar')

2. get_video_info

Get comprehensive video metadata

• video_url: YouTube video URL or ID

3. get_channel_info

Fetch channel statistics and details

• channel_id: YouTube channel ID or URL

4. get_video_comments

Retrieve video comments

• video_url: YouTube video URL or ID
• max_results: Number of comments (default: 100)

5. search_videos

Search for videos

• query: Search keywords
• max_results: Number of results (default: 10)

6. get_channel_videos

List videos from a channel

• channel_id: YouTube channel ID
• max_results: Number of videos (default: 50)

Security & Privacy

✅ API keys stored in environment variables only
✅ Official YouTube Data API v3
✅ Rate limiting to respect quotas
✅ Input validation on all URLs
✅ No data storage or logging

API Quota

YouTube Data API v3 provides 10,000 units/day free:

• Video search: 100 units
• Video details: 1 unit
• Comments: 1 unit

Monitor usage: Google Cloud Console

Development Status

🚧 Currently in active development - Basic functionality ready, advanced features coming soon.

License

MIT License

Support

Issues: GitHub Issues