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

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

  • get_channel

    Get a YouTube channel by ID or handle.

  • list_uploads

    List videos from the authenticated channel uploads playlist.

  • list_videos

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

  • get_video

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

  • list_playlists

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

  • list_playlist_items

    List videos in a YouTube playlist.

  • search_channel_content

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

  • list_comment_threads

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

  • list_comment_replies

    List replies to a top-level comment.

  • list_activities

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

  • list_members

    List channel members (sponsors) for the authenticated channel.

  • list_membership_levels

    List membership pricing levels for the authenticated channel.

  • list_captions

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

  • list_video_categories

    List YouTube video categories available in a region.

  • query_analytics_report

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

  • list_reporting_report_types

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

  • list_reporting_jobs

    List YouTube Reporting API jobs that generate bulk CSV reports.

  • get_reporting_job

    Get details for a YouTube Reporting API job.

  • download_reporting_report

    Download a completed YouTube Reporting API report as CSV text.

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

Related workflows

Multi-integration playbooks that use YouTube to solve concrete business outcomes.

Create account Documentation