Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
YOUTUBE_API_KEYNoYour YouTube Data API key. Needed for the public read tools.
YOUTUBE_MCP_STATE_DIRNoOptional directory where local state lives. Defaults to ~/.youtube-mcp.
YOUTUBE_MCP_CHANNEL_IDNoYour channel ID (starts with UC). Needed for creator tools; the signed-in account must own it.
YOUTUBE_MCP_PROFILE_IDNoA profile name you choose, e.g. creator-main. Needed for creator tools; keeps local state separate per profile.
YOUTUBE_OAUTH_CLIENT_SECRET_FILENoAbsolute 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

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

B3.1/5.0

Scored across 79 tools

Disambiguation4/5

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.

Naming Consistency4/5

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.

Tool Count2/5

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.

Completeness4/5

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.

Maintenance

ActivityNo data
ResponsivenessOutdated data