Skip to main content
Glama
youtube-organic-mcp

youtube-organic-mcp

by lanternrow

youtube-organic-mcp

MCP server for YouTube organic analytics — channel stats, video performance, watch time, and audience engagement via the YouTube Data API v3 and YouTube Analytics API v2.

Built for Claude Code and any MCP-compatible AI tool. Gives your AI assistant direct, read-only access to your own channel's organic data — subscribers, views, watch time, per-video engagement, and day-by-day trends.

Part of The SEO Engine toolkit by Rex Jones — AI-powered SEO and social media tooling for agencies and businesses.

Why this exists

  • No good open-source YouTube organic MCP existed. Plenty of ad MCPs; organic channel analytics, nobody.

  • YouTube has the richest organic API of the major platforms. Watch time, average view duration, subscribers gained/lost, traffic sources — none of it gated behind a multi-week review.

  • Reuses your existing Google OAuth. If you already run the GA4 / GSC / Google Ads MCPs, the same OAuth client works here.

Related MCP server: YouTube MCP Server

Tools

Tool

Description

list_accounts

List configured channels and the default

get_channel_info

Channel profile + lifetime stats (subscribers, total views, video count, uploads playlist)

get_videos

Paginated uploads with per-video views, likes, comments, duration

get_video_details

Details for specific video IDs (batch up to 50)

get_channel_analytics

Channel analytics over a date range: views, watch time, avg view duration/%, subs gained/lost, likes, comments, shares — optionally by day

get_video_analytics

The same metrics for a single video over a date range

All tools accept an optional account parameter for multi-account setups.

Getting connected

Step 1: Enable the APIs

In Google Cloud Console (any project — you can reuse an existing one), enable YouTube Data API v3 and YouTube Analytics API.

Step 2: Get a refresh token

Create an OAuth client of type Desktop app and download its client_secret JSON. Then run the helper (needs pip install google-auth-oauthlib):

python3 scripts/get_youtube_token.py /path/to/client_secret.json my-channel

Authorize with the Google account that owns the channel (pick the Brand Account if prompted). It prints the three YOUTUBE_* values to drop into your config and writes them to .youtube_account.json (gitignored).

Step 3: Configure

Add to your Claude Code MCP settings:

{
  "mcpServers": {
    "youtube-organic": {
      "command": "node",
      "args": ["/path/to/youtube-organic-mcp/dist/index.js"],
      "env": {
        "YOUTUBE_CLIENT_ID": "your_client_id.apps.googleusercontent.com",
        "YOUTUBE_CLIENT_SECRET": "your_client_secret",
        "YOUTUBE_REFRESH_TOKEN": "1//your_refresh_token"
      }
    }
  }
}

Or set YOUTUBE_ACCOUNTS to a JSON array for multiple channels (see .env.example).

Architecture

src/
  index.ts          # MCP server entry point, tool registration
  accounts.ts       # Multi-account resolution (client_id/secret/refresh_token)
  client.ts         # OAuth token minting + Data/Analytics API HTTP client
  types.ts          # TypeScript interfaces for API responses
  tools/
    channel.ts      # get_channel_info + uploads-playlist resolver
    videos.ts       # get_videos, get_video_details
    analytics.ts    # get_channel_analytics, get_video_analytics
  • Zero external HTTP dependencies — native fetch (Node 18+)

  • Auto-refreshing auth — access tokens minted from the refresh token, cached per process

  • Multi-account support — monitor multiple channels from one server

License

MIT

Available Tools

6 tools
get_channel_analyticsA

Get channel-level organic analytics over a date range: views, estimated minutes watched, average view duration/percentage, subscribers gained/lost, likes, comments, shares. Optionally break down by a dimension (e.g. 'day' for a daily time series). Requires the yt-analytics.readonly scope.

Inputs: end_date (required), start_date (required), account, metrics, +1 more.

get_channel_infoA

Get the authorized YouTube channel's profile and lifetime stats: title, description, custom URL, subscriber count, total views, and video count.

Inputs: account.

get_video_analyticsA

Get analytics for a single video over a date range (views, watch time, average view duration/percentage, subscribers gained, likes, comments, shares). Requires the yt-analytics.readonly scope.

Inputs: end_date (required), video_id (required), start_date (required), account, +1 more.

get_video_detailsA

Get details (views, likes, comments, duration, tags) for specific YouTube video IDs. Max 50 IDs per request.

Inputs: video_ids (required), account.

get_videosA

Get a paginated list of the channel's uploaded videos with engagement metrics (views, likes, comments, duration). Returns up to 50 per page.

Inputs: account, page_token, max_results.

list_accountsA

List all configured YouTube accounts available for querying.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool targets a distinct aspect: channel analytics, channel info, video analytics, video details, video listing, and account listing. No overlap or ambiguity between tool purposes.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern with snake_case: 'get_' for data retrieval and 'list_' for account listing. Naming is predictable and uniform.

    Tool Count5/5

    With 6 tools, the set is well-scoped for YouTube channel analytics: covers channel stats, video details, and both channel- and video-level analytics. Neither too few nor too many.

    Completeness4/5

    The tool surface covers core organic analytics needs: channel profile, video list with metrics, and detailed analytics per video/channel. Minor gaps exist, like lacking search or filtering capabilities, but the core workflows are supported.

    Related MCP Connectors

    Related MCP Servers