stackgate.ai
All integrations

YouTube

Channel stats, video catalog, audience engagement, and analytics for creators.

OAuth 20 tools

Overview

Connect YouTube to give AI clients read-only access to your channel metadata, video catalog, audience engagement, and analytics — including monetization metrics when your channel is in the YouTube Partner Program.

Prerequisites

  • A Google account with an associated YouTube channel
  • Monetization metrics require a monetized channel (YouTube Partner Program)
  • A stackgate.ai account

Getting credentials

  1. Ensure your Google Cloud project has YouTube Data API v3, YouTube Analytics API, and YouTube Reporting API enabled (same OAuth client as Gmail works).
  2. Sign in to stackgate.ai.
  3. Go to My Integrations and open YouTube.
  4. Click Connect YouTube and approve Google OAuth (channel read, analytics, and monetization scopes).
  5. stackgate.ai stores your tokens securely and caches your channel ID.

No manual API keys are required.

Using with AI clients

  • Dedicated endpoint: POST /mcp/youtube with a Sanctum bearer token
  • Private gateway: one config for all integrations — use youtube__* namespaced tools

See Documentation for HTTP authentication and private gateway setup.

Troubleshooting

  • 422 integration not configured — complete the OAuth connect flow in My Integrations.
  • Token expired — disconnect and reconnect YouTube from the integration page.
  • Empty revenue metrics — your channel may not be monetized; non-monetized channels return empty monetization data.
  • Quota errors — the hub shares a daily YouTube Data API quota; avoid heavy use of search tools.

Available tools

  • get-my-channel-tool

    Get the authenticated creator channel metadata, statistics, content details, and branding.

  • get-channel-tool

    Get a YouTube channel by ID or handle.

  • list-uploads-tool

    List videos from the authenticated channel uploads playlist.

  • list-videos-tool

    List one or more YouTube videos by ID with snippet, statistics, and content details.

  • get-video-tool

    Get a single YouTube video by ID with metadata and statistics.

  • list-playlists-tool

    List playlists for the authenticated channel or a specific channel ID.

  • list-playlist-items-tool

    List videos in a YouTube playlist.

  • search-channel-content-tool

    Search YouTube for videos, playlists, or channels. Costs 100 Data API quota units per call — use sparingly.

  • list-comment-threads-tool

    List comment threads on a video or all threads related to a channel.

  • list-comment-replies-tool

    List replies to a top-level comment.

  • list-activities-tool

    List recent channel activity events such as uploads, likes, and shares.

  • list-members-tool

    List channel members (sponsors) for the authenticated channel.

  • list-membership-levels-tool

    List membership pricing levels for the authenticated channel.

  • list-captions-tool

    List caption track metadata for a video (not the caption file contents).

  • list-video-categories-tool

    List YouTube video categories available in a region.

  • query-analytics-report-tool

    Query YouTube Analytics for views, watch time, demographics, traffic sources, and monetization metrics.

  • list-reporting-report-types-tool

    List available YouTube Reporting API report types for bulk historical exports.

  • list-reporting-jobs-tool

    List YouTube Reporting API jobs that generate bulk CSV reports.

  • get-reporting-job-tool

    Get details for a YouTube Reporting API job.

  • download-reporting-report-tool

    Download a completed YouTube Reporting API report as CSV text.

MCP endpoint: https://stackgate.ai/mcp/youtube (HTTP) or via the private gateway.

Create account Documentation