Integration

YouTube Analytics integration

YouTube Analytics and Reporting API for accessing channel and video performance metrics. Query views, watch time, revenue, audience demographics, traffic sources, and engagement data for YouTube content creators and businesses.

Connect YouTube Analytics How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in YouTube Analytics.Built from the 24 YouTube Analytics tools below, on the connection you add once.

Common YouTube Analytics use cases

automate group management
automate group item management
get group programmatically
list group programmatically
create group programmatically
delete group programmatically
update group programmatically
add group item programmatically
list group item programmatically
remove group item programmatically

What you can do with YouTube Analytics

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Group, 5 operations

create_groupCreate groupPOSTCreate a new YouTube Analytics group for organizing videos, channels, or other resources.
delete_groupDelete groupDELETEDelete a YouTube Analytics group.
get_groupGet groupGETGet a specific YouTube Analytics group by its ID.
list_groupsList groupsGETList YouTube Analytics groups owned by the authenticated user or by ID.
update_groupUpdate groupPUTUpdate the title of an existing YouTube Analytics group.

Group item, 3 operations

add_group_itemAdd group itemPOSTAdd an item (video, channel, playlist, or asset) to a YouTube Analytics group.
list_group_itemsList group itemsGETList all items (videos, channels, playlists, or assets) in a YouTube Analytics group.
remove_group_itemRemove group itemDELETERemove an item from a YouTube Analytics group.

Audience retention report, 1 operation

query_audience_retention_reportQuery audience retention reportGETQuery the audience retention report for a specific video, showing the relative audience watching at each point of the video.

Channel analytic, 1 operation

query_channel_analyticsQuery channel analyticsGETQuery analytics reports for your own channel. Returns metrics like views, watch time, and average view duration over a date range.

Content owner analytic, 1 operation

query_content_owner_analyticsQuery content owner analyticsGETQuery analytics reports for a content owner (multi-channel network). Returns aggregated metrics across managed channels.

Demographics report, 1 operation

query_demographics_reportQuery demographics reportGETQuery audience demographic data broken down by age group and gender. Returns viewer percentage for each demographic segment.

Device report, 1 operation

query_device_reportQuery device reportGETQuery device and operating system data showing what devices viewers use to watch your content.

Engagement report, 1 operation

query_engagement_reportQuery engagement reportGETQuery engagement metrics including likes, dislikes, shares, comments, and subscriber changes.

Geography report, 1 operation

query_geography_reportQuery geography reportGETQuery geographic data showing views and watch time broken down by country.

Live streaming report, 1 operation

query_live_streaming_reportQuery live streaming reportGETQuery live streaming analytics with live vs on-demand breakdown. Shows metrics filtered by live or on-demand content.

Playback location report, 1 operation

query_playback_location_reportQuery playback location reportGETQuery the playback location report, broken down by where the video was played (watch page, embedded, channel page, etc.).

Playlist report, 1 operation

query_playlist_reportQuery playlist reportGETQuery playlist performance data including views, watch time, and playlist starts.

Revenue report, 1 operation

query_revenue_reportQuery revenue reportGETQuery estimated revenue and monetization metrics for your channel. Includes ad revenue, Red partner revenue, CPM, and monetized playbacks.

Sharing service report, 1 operation

query_sharing_service_reportQuery sharing service reportGETQuery the sharing service report, showing how many times videos were shared via each external service.

Subscriber status report, 1 operation

query_subscriber_status_reportQuery subscriber status reportGETQuery analytics broken down by subscriber vs non-subscriber status. Shows how subscribed and unsubscribed viewers engage differently.

Subscription status report, 1 operation

query_subscription_status_reportQuery subscription status reportGETQuery analytics broken down by subscribed vs unsubscribed viewer status, showing engagement metrics for each group.

Traffic source, 1 operation

query_traffic_sourcesQuery traffic sourcesGETQuery traffic source data showing how viewers found your content. Breaks down views and watch time by traffic source type.

OAuth scopes YouTube Analytics requires

Each operation declares the scopes YouTube Analytics requires for it.

https://www.googleapis.com/auth/yt-analytics.readonlyneeded by add_group_item, create_group, delete_group and 20 more
https://www.googleapis.com/auth/yt-analytics-monetary.readonlyneeded by add_group_item, create_group, delete_group and 3 more
https://www.googleapis.com/auth/youtubeneeded by add_group_item, create_group, delete_group and 2 more
https://www.googleapis.com/auth/youtubepartnerneeded by add_group_item, create_group, delete_group and 2 more

Use YouTube Analytics from Claude Code, Cursor or Codex

Connect YouTube Analytics in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its YouTube Analytics operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect YouTube Analytics

Create your workspace
Sign up free. Nothing to install.
Connect YouTube Analytics once
Add your YouTube Analytics connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.

YouTube Analytics integration FAQ

What can you do with the YouTube Analytics integration?

LiveContext exposes 24 operations on YouTube Analytics, covering group, group item, audience retention report and channel analytic. Common uses include automate group management, automate group item management and get group programmatically.

Which OAuth scopes does YouTube Analytics require?

It depends on the operation: each one declares the scopes YouTube Analytics requires for it. The most common are https://www.googleapis.com/auth/yt-analytics.readonly (23 operations), https://www.googleapis.com/auth/yt-analytics-monetary.readonly (6 operations), https://www.googleapis.com/auth/youtube (5 operations) and https://www.googleapis.com/auth/youtubepartner (5 operations).