YouTube Studio & Channel Analytics MCP Server

A Production-Grade Model Context Protocol (MCP) Server for YouTube Studio & Channel Intelligence

Empower AI assistants (Claude, Cursor, Antigravity, etc.) to analyze your YouTube channel, track video metrics, deep-dive into YouTube Studio analytics, discover audience traffic sources, and analyze community sentiment — configured entirely through .env.

🚀 Features & MCP Tool Suite

YouTube Studio MCP provides 8 specialized tools:

Related MCP server: YouTube MCP Server

⚙️ Environment Configuration (.env)

All credentials and settings are read directly from .env:

# Google OAuth 2.0 Credentials (from Google Cloud Console)
YOUTUBE_CLIENT_ID=your_client_id.apps.googleusercontent.com
YOUTUBE_CLIENT_SECRET=your_client_secret

# OAuth Refresh Token (written automatically by run_auth.py)
YOUTUBE_REFRESH_TOKEN=

🛠️ Step-by-Step Setup Guide

1. Clone & Install Dependencies with uv

git clone https://github.com/Dhananjayrbiraris/youtube-mcp.git
cd youtube-mcp

uv venv
uv pip install -e .

2. Set Up Google Cloud Project (One-Time)

1. Open Google Cloud Console.

2. Create a new project (e.g. YouTube-Studio-MCP).

3. In APIs & Services > Library, enable:

   • YouTube Data API v3

   • YouTube Analytics API

4. In OAuth consent screen:

   • User Type: External -> fill app name & your email.

   • Under Test users, add your Google email address.

5. In Credentials:

   • Click Create Credentials > OAuth client ID.

   • Application Type: Desktop App.

   • Copy the Client ID and Client Secret.

6. Paste them into .env:

   YOUTUBE_CLIENT_ID=123456789-xxxx.apps.googleusercontent.com
   YOUTUBE_CLIENT_SECRET=GOCSPX-xxxx

3. Run 1-Click Authenticator

uv run run_auth.py

This launches your browser for a 1-click Google OAuth login. It automatically writes the YOUTUBE_REFRESH_TOKEN directly into your .env file.

4. Connect to your AI Client

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "youtube-studio": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/youtube-mcp",
        "run",
        "youtube-studio-mcp"
      ]
    }
  }
}

💡 Example AI Prompts

• "Give me an overview of my YouTube channel's performance over the last 28 days."

• "Where is most of my traffic coming from (search, suggested videos, or browse features)?"

• "Which of my videos generated the most subscribers this month?"

• "Summarize common themes and questions from the comments on my latest video."

• "Show me my audience breakdown by age group and country."

🧪 Testing

Run the test suite:

pytest

📄 License

This project is licensed under the MIT License.