YouTube MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| YOUTUBE_API_KEY | No | Your YouTube Data API key. Needed for the public read tools. | |
| YOUTUBE_MCP_STATE_DIR | No | Optional directory where local state lives. Defaults to ~/.youtube-mcp. | |
| YOUTUBE_MCP_CHANNEL_ID | No | Your channel ID (starts with UC). Needed for creator tools; the signed-in account must own it. | |
| YOUTUBE_MCP_PROFILE_ID | No | A profile name you choose, e.g. creator-main. Needed for creator tools; keeps local state separate per profile. | |
| YOUTUBE_OAUTH_CLIENT_SECRET_FILE | No | Absolute path to the Desktop OAuth client JSON. Needed for account and creator tools. |
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 |
|---|---|
| youtube_searchA | Search public YouTube videos (100 quota units per call). Optional filters: order, publishedAfter/publishedBefore (RFC 3339), videoDuration, channelId, regionCode, relevanceLanguage, safeSearch, pageToken. |
| youtube_trendingA | List the most popular videos for a region (default US), optionally in one video category. 1 quota unit. |
| youtube_list_channel_videosA | List recent uploads with statistics for ANY public channel, by channel ID or @handle (about 3 quota units per page). |
| youtube_get_videoB | Get a public YouTube video by ID. |
| youtube_get_channelB | Get a public YouTube channel by ID. |
| youtube_get_commentsA | List public comment threads for a specific video. |
| youtube_get_transcriptB | Get a best-effort public transcript for a video. |
| youtube_my_accountB | Get the authenticated YouTube channel. |
| youtube_list_subscriptionsA | List subscriptions for the authenticated account, with pagination. details: true adds subscriberCount, videoCount and lastUploadAt per channel and costs about 1 extra quota unit per returned channel. |
| youtube_list_channel_comment_threadsA | List comment threads associated with the authenticated channel; authors may be anyone. |
| youtube_subscribeC | Subscribe the authenticated account to a channel. |
| youtube_unsubscribeB | Remove an authenticated-account subscription. |
| youtube_rate_videoC | Rate a video for the authenticated account. |
| youtube_create_commentA | Create a top-level comment as the selected channel, only on a video that channel owns (replies on your own videos); other videos are refused with ownership_required. |
| youtube_creator_overviewB | Get owned-channel creator analytics for a date range. |
| youtube_creator_top_videosC | Get top owned-channel videos for a date range. |
| youtube_creator_retentionB | Get audience-retention data for an owned video. |
| youtube_creator_reportA | Run an allowlisted YouTube Analytics report for the owned channel (default: last 28 days). Metrics: views, estimatedMinutesWatched, averageViewDuration, averageViewPercentage, subscribersGained, subscribersLost, likes, comments, shares (viewerPercentage only with ageGroup/gender). Dimensions: day, month, video, country, deviceType, operatingSystem, insightTrafficSourceType, insightTrafficSourceDetail (needs one video plus an insightTrafficSourceType filter), ageGroup, gender, subscribedStatus, sharingService (shares only). Invalid combinations are rejected with invalid_input before any API call. Rows come back as objects keyed by column name. |
| youtube_list_owned_videosC | List videos owned by the selected creator profile. |
| youtube_get_owned_videoB | Get a video owned by the selected creator profile. |
| youtube_list_video_categoriesB | List available YouTube video categories with freshness metadata. |
| youtube_list_playlistsB | List playlists owned by the selected creator profile. |
| youtube_get_playlistB | Get one playlist owned by the selected creator profile. |
| youtube_list_playlist_itemsA | List items from an owned creator playlist. |
| youtube_list_moderation_commentsC | List selected-channel moderation threads with available replies. |
| youtube_get_moderation_commentA | Read one immutable comment by ID for exact moderation reconciliation. |
| youtube_find_comment_replyB | Exhaustively find an exact selected-channel reply under one immutable parent comment. |
| youtube_list_caption_tracksA | List caption tracks for an owned creator video. |
| youtube_approveA | Approve ANY pending preflight preview (upload, metadata, archive, thumbnail, caption, playlist, comment reply/moderation/delete, channel profile edit, bulk unsubscribe) by approvalId, with confirm: true. The result echoes the operation kind, target and exact desired change so the human can see precisely what is approved. Approval is single-use, expires, and is bound to the active profile and channel; then call the matching execute tool with confirm: true. |
| youtube_preflight_uploadC | Validate and preview a private resumable video upload. |
| youtube_upload_videoB | Start an approved resumable video upload. Public visibility also needs publish: true. |
| youtube_preflight_resume_uploadC | Validate and preview an explicit resumable-upload continuation. |
| youtube_resume_uploadA | Resume an approved upload only after probing its existing session. |
| youtube_get_upload_statusB | Probe a resumable upload session without sending media bytes. |
| youtube_preflight_cancel_uploadC | Preview cancellation of a resumable upload session. |
| youtube_cancel_uploadC | Cancel an approved resumable upload session. |
| youtube_preflight_update_metadataC | Read, merge, and preview an owned-video metadata update. publishAt only works on a private video that has never been public, with a future ISO 8601 time. |
| youtube_update_metadataA | Write approved merged owned-video metadata. Public, scheduled, and synthetic-media changes need elevated intent. publishAt only works on a private video that has never been public, with a future ISO 8601 time. |
| youtube_preflight_archive_videoA | Preview archiving an owned video: sets it to private and clears any scheduled publish time; title, description and everything else stay untouched. Reversible: make it public or unlisted again with youtube_update_metadata. Refuses with already_archived if it is already private and unscheduled. |
| youtube_archive_videoA | Archive an approved owned video (private, not scheduled; reversible via youtube_update_metadata). Approve the preview with youtube_approve, then call with confirm: true. |
| youtube_preflight_set_thumbnailC | Validate and preview an owned-video thumbnail. |
| youtube_set_thumbnailB | Set an approved thumbnail on an owned video. |
| youtube_preflight_caption_uploadC | Validate and preview a caption upload for an owned video. |
| youtube_upload_captionA | Upload an approved caption file without returning media bytes. |
| youtube_preflight_caption_updateB | Validate and preview an owned caption update. |
| youtube_update_captionC | Update an approved owned caption track. |
| youtube_download_captionA | Download an owned caption track into /downloads/ as a new file you name with fileName (a plain name, no paths). Formats: srt, ttml, vtt, sbv. With format, the extension must match (.srt, .ttml, .vtt, .sbv). Without format you get the track original; use any of those four extensions. Never overwrites; bytes are not returned, the absolute path written is. Read-only on YouTube: no approval needed; ownership of the video and caption is verified first. |
| youtube_preflight_caption_deleteB | Preview deletion of an owned caption track. |
| youtube_delete_captionB | Delete an approved owned caption track. |
| youtube_preflight_create_playlistB | Preview creation of a creator playlist; private is the default visibility. |
| youtube_create_playlistC | Create an approved creator playlist. |
| youtube_preflight_update_playlistB | Read and preview an update to an owned playlist. |
| youtube_update_playlistC | Update an approved owned playlist. |
| youtube_preflight_delete_playlistB | Read and preview deletion of an owned playlist. |
| youtube_delete_playlistA | Delete an approved owned playlist. |
| youtube_preflight_add_playlist_itemC | Read and preview adding a video to an owned playlist. |
| youtube_add_playlist_itemB | Add a video to an approved owned playlist. |
| youtube_preflight_remove_playlist_itemB | Read and preview removal of an immutable playlist item. |
| youtube_remove_playlist_itemA | Remove an approved immutable playlist item. |
| youtube_preflight_reorder_playlist_itemC | Read and preview reordering an immutable playlist item. |
| youtube_reorder_playlist_itemB | Reorder an item after an approved preview. |
| youtube_preflight_reply_to_commentC | Read and preview a reply to an immutable creator-channel comment. |
| youtube_reply_to_commentB | Reply to an approved immutable creator-channel comment. |
| youtube_preflight_set_comment_moderation_statusC | Read and preview a comment moderation action; banning requires elevated intent. |
| youtube_set_comment_moderation_statusA | Set an approved comment moderation status; banAuthor requires elevated intent. |
| youtube_preflight_delete_commentC | Read and preview deletion of an immutable creator-channel comment. |
| youtube_delete_commentB | Delete an approved immutable creator-channel comment. |
| youtube_preflight_update_channelA | Preview an edit to the selected creator channel profile (description, keywords, country, defaultLanguage), showing current vs desired. Other branding settings are preserved on execute. |
| youtube_update_channelA | Apply an approved channel profile edit (read-modify-write of brandingSettings so untouched fields are kept). Approve with youtube_approve, then call with confirm: true and the same fields. youtube_my_account shows the snippet description, which can lag the stored branding description for a while. |
| youtube_preflight_unsubscribe_manyA | Preview removing up to 100 subscriptions of the authenticated account: verifies each belongs to the account and lists every channel title to be removed, with approximate quota (50 units per removal). |
| youtube_unsubscribe_manyA | Remove the approved subscriptions one by one and report each as removed, already_gone, failed (definitively rejected) or unknown (outcome uncertain after a server or network error: reconcile with youtube_list_subscriptions before retrying). Stops early (with a partial report) if YouTube quota runs out. Approve with youtube_approve first, then call with confirm: true. |
| youtube_import_takeoutA | Import a local Google Takeout YouTube-history JSON or HTML file into local derived analytics. |
| youtube_consumption_profileB | Summarize local consumption analytics for a date range. |
| youtube_consumption_trendsC | Compare local consumption topics across two date ranges. |
| youtube_save_curation_policyC | Save selected-profile local curation allowlists and API-data retention. |
| youtube_save_curation_candidateC | Save a selected-profile local curation candidate with source provenance. |
| youtube_propose_consumption_queueC | Create a finite selected-profile local consumption queue. |
| youtube_reset_consumption_dataA | Delete selected-profile local curation policy, candidates, and queues. |
| youtube_auth_statusB | Report safe local YouTube authorization readiness. |
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 79 tools
Most tools are clearly separated by resource and context: public video/channel reads, owned-creator operations, selected-channel moderation, analytics, uploads, and preflight/execute pairs. The main ambiguity comes from the large number of similar-sounding comment, video, and analytics tools, which could still cause misselection at scale.
The set overwhelmingly follows a youtube_ + snake_case action pattern, with clear preflight/execute prefixes. Minor deviations such as youtube_search, youtube_trending, youtube_my_account, and youtube_auth_status are still readable but slightly break the verb_noun convention.
Seventy-nine tools is far too many for practical selection and is inflated by many preflight/execute pairs. The YouTube creator/public/moderation domain is broad, but this surface is heavy and likely burdens an agent despite granular descriptions.
Coverage is very broad: public search/read, owned-creator analytics, upload lifecycle, metadata, thumbnails, captions, playlists, comments, moderation, subscriptions, and local Takeout analytics are represented. Minor gaps remain, such as owned-video deletion and some channel/branding or live-streaming workflows, but core lifecycles are covered.