youtube-studio-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| YTS_DATA_DIR | No | Directory for storing OAuth credentials and cache. Defaults to ~/.youtube-studio-mcp. | ~/.youtube-studio-mcp |
| YTS_CACHE_TTL | No | Cache time-to-live in seconds. Defaults to 3600. | 3600 |
| YTS_PILLARS_FILE | No | Path to the pillars JSON file mapping videoIds to content pillars. Defaults to config/pilares.json. | config/pilares.json |
| YTS_CLIENT_SECRET | No | Path to the OAuth client secret JSON file downloaded from Google Cloud Console. Defaults to $YTS_DATA_DIR/client_secret.json. | $YTS_DATA_DIR/client_secret.json |
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": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_channel_overviewA | Basic stats of the authenticated owner's YouTube channel: subscribers, total views, video count and uploads playlist id. Cached locally; pass refresh=true to bypass the cache. |
| get_channel_metricsA | Channel metrics from the YouTube Analytics API for a date range (default: last 28 days): views, minutes watched, average view duration, subscribers gained/lost and net. Dates are YYYY-MM-DD. Cached per range. |
| list_videosA | Every uploaded video (id, title, publish date, ISO-8601 duration) via the uploads playlist. Cached; pass refresh=true to bypass the cache. |
| get_retention_curveA | Audience retention curve for one video: a list of points {ratio, watch_ratio, relative} across the video's elapsed-time ratio. |
| analyze_pillar_performanceA | Group each mapped video's watch time and retention by content pillar (config/pilares.json) and rank pillars by minutes watched. Unmapped videos land in a 'não classificado' bucket. Derived from cached metrics. |
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 5 tools
Each tool targets a distinct resource or analytical view: channel overview, channel analytics, video list, retention curve, and pillar aggregation. Even the two channel-level tools are clearly separated by cached current stats vs. date-range analytics.
Tool names follow a consistent verb_noun pattern: get_ for single retrievals, list_ for collections, and analyze_ for derived analysis. All names use snake_case and clearly communicate their action.
Five tools is a well-scoped size for an analytics-focused YouTube Studio server. Each tool serves a distinct part of the workflow without unnecessary redundancy or sprawl.
The set covers channel-level stats, video listing, retention, and pillar analysis, but there are notable gaps such as per-video performance metrics, video metadata updates, and any management actions. It works well for read-only analytics but is not a complete YouTube Studio surface.