🎬 YouTube MCP Server: Remote MCP on Cloudflare Workers

A powerful Model Context Protocol (MCP) server that provides AI assistants with comprehensive YouTube analytics and channel management capabilities. Built with TypeScript, deployed on Cloudflare Workers, and secured with Google OAuth.

✨ Features

📊 YouTube Analytics

• Channel Performance: Revenue, views, subscriber growth, engagement metrics
• Video Analytics: Deep performance analysis with retention rates and traffic sources
• Audience Insights: Demographics, geography, device usage, and viewing patterns
• Top Content: Identify best-performing videos by views, revenue, or engagement

🎯 Content Strategy Tools

• Trending Analysis: AI-powered content suggestions based on current trends
• Competitor Intelligence: Analyze competitor channels and identify content gaps
• Performance Optimization: Recommendations based on your channel's data

🔍 YouTube Data Access

• Video Search: Find videos across YouTube with advanced filtering
• Channel Information: Get detailed channel stats and recent uploads
• Video Details: Comprehensive metadata, stats, and engagement data

🛠️ Quick Start

Prerequisites

• YouTube channel with uploaded content
• Google Cloud Console project with YouTube APIs enabled
• Cloudflare Workers account

1. Clone and Install

git clone https://github.com/lauragift21/youtube-mcp-server.git
cd youtube-mcp-server
npm install

2. Configure OAuth

1. Create Google OAuth Credentials:

   • Go to Google Cloud Console
   • Enable YouTube Data API v3 and YouTube Analytics API
   • Create OAuth 2.0 credentials (Web Application)
   • Add redirect URI: https://your-worker.workers.dev/callback

2. Set Environment Variables:

   npx wrangler secret put GOOGLE_OAUTH_CLIENT_ID
   npx wrangler secret put GOOGLE_OAUTH_CLIENT_SECRET
   npx wrangler secret put COOKIE_ENCRYPTION_KEY

You can generate a random string for COOKIE_ENCRYPTION_KEY

3. Deploy

npx wrangler deploy

Connect to Claude Desktop

Add to your Claude Desktop configuration:

{
  "mcpServers": {
    "youtube-mcp-server": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://your-deployment.workers.dev/sse"
      ]
    }
  }
}

Connect to Cloudflare AI Playground

You can connect your MCP server from the Cloudflare AI Playground, which is a remote MCP client:

• Go to https://playground.ai.cloudflare.com/
• Enter your deployed MCP server URL (remote-mcp-server-authless..workers.dev/sse)
• You can now use your MCP tools directly from the playground!

🔧 Available Tools

Analytics Tools

• youtube_getChannelAnalytics - Get channel performance metrics
• youtube_analyzeVideoPerformance - Deep dive into video performance
• youtube_getTopVideos - Find your best-performing content
• youtube_getAudienceDemographics - Understand your viewers

Content Strategy Tools

• youtube_suggestContentIdeas - AI-powered topic suggestions
• youtube_analyzeCompetitors - Competitive analysis and benchmarking

Data Tools

• youtube_searchVideos - Search YouTube with advanced filters
• youtube_getVideoDetails - Get comprehensive video information
• youtube_getChannelInfo - Channel overview and statistics
• youtube_getChannelVideos - Recent uploads from any channel

💡 Example Queries

Try these questions with Claude Desktop:

📈 Channel Analytics

"Show me my YouTube channel performance for the past 30 days"

🎯 Content Strategy

"What should I make a video about next in the AI/tech space?"

"Analyze my competitors and show me content opportunities I'm missing"

👥 Audience Insights

"Who are my viewers? Show me demographics and geography data"

🏗️ Architecture

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   Claude Desktop │────│  MCP Server      │────│ YouTube APIs    │
│   (MCP Client)   │    │  (Cloudflare)    │    │ (Google)        │
└─────────────────┘    └──────────────────┘    └─────────────────┘
                                │
                       ┌──────────────────┐
                       │  OAuth Provider  │
                       │  (Google Auth)   │
                       └──────────────────┘

Key Components

• MCP Server: Handles tool requests and API communication
• OAuth Provider: Manages Google authentication and token refresh
• YouTube Data API: Public video and channel information
• YouTube Analytics API: Private channel analytics and revenue data

🔗 Links

• Model Context Protocol - Learn about MCP
• YouTube Data API - YouTube API documentation
• Cloudflare Workers - Serverless deployment platform
• Claude Desktop - AI assistant with MCP support

---

Built with ❤️ by Gift Egwuenu | Powered by MCP & Cloudflare Workers