youtube-organic-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| YOUTUBE_ACCOUNTS | No | JSON array of account objects (each with client_id, client_secret, refresh_token) for multiple channels | |
| YOUTUBE_CLIENT_ID | No | Google OAuth client ID | |
| YOUTUBE_CLIENT_SECRET | No | Google OAuth client secret | |
| YOUTUBE_REFRESH_TOKEN | No | OAuth refresh token for the YouTube account |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_accountsA | List all configured YouTube accounts available for querying. |
| get_channel_infoA | Get the authorized YouTube channel's profile and lifetime stats: title, description, custom URL, subscriber count, total views, and video count. |
| 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. |
| get_video_detailsA | Get details (views, likes, comments, duration, tags) for specific YouTube video IDs. Max 50 IDs per request. |
| 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. |
| 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. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 6 tools
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.
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.
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.
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.