Skip to main content
Glama

YouTube MCP

A local-first MCP server that lets AI assistants search YouTube, manage your channel and read your analytics, and asks you to approve changes to your channel and content first.

License: MIT CI Latest release Node.js >=22.13 MCP server

YouTube MCP is a Model Context Protocol server written in TypeScript. It exposes 79 tools to MCP clients such as Claude Code, Claude Desktop, Cursor and Codex. It runs on your own machine over stdio, keeps its OAuth tokens and working data on your disk, and never starts a network listener unless you ask for one.

Anything that changes your YouTube account goes through a preflight, approve, execute flow. The assistant first shows you exactly what it is about to do, and nothing happens until the exact previewed change is approved.

Quick start

  1. Get your keys. Follow the beginner setup guide (5 minutes for public research, about 15 with your own channel).

  2. Install in your agent. Pick yours in Install in your AI agent.

  3. Sign in once (only for your own channel): run the youtube-auth command in Account and creator tools.

  4. Ask your agent: "Check my YouTube auth status", then "Search YouTube for talks about MCP".

Related MCP server: YouTube Studio MCP

What it can do

Read (no account needed, just an API key)

  • Search videos (with order, date, duration, channel, region and safe-search filters), see what is trending, list the recent uploads of any channel, look up videos and channels.

  • List the public comments on a video.

  • Fetch a public transcript (best effort; some videos have none).

Read (your own account and channel, via OAuth)

  • Your channel, your subscriptions, and comment threads on your channel.

  • Creator analytics: channel overview, top videos and audience retention for a date range, plus a flexible report (views by day, traffic sources, devices, countries, demographics and more).

  • Your uploaded videos, playlists and playlist items, caption tracks, and the comment moderation queue.

Write (your own account; channel and content changes need preview and approval, viewer actions need confirm: true)

  • Uploads: resumable video uploads, with status check, resume and cancel. Uploads are private unless you explicitly ask to publish.

  • Videos: update title, description and other metadata, and set thumbnails.

  • Captions: upload, update, download and delete caption tracks.

  • Playlists: create, update, delete, and add, remove or reorder items. New playlists default to private.

  • Comments and moderation: reply to comments, set a moderation status (including banning an author), and delete comments on your channel.

  • Channel profile: edit your channel description, keywords, country and default language.

  • Subscription curation: review subscriptions with subscriber counts and last upload date, then remove many at once after one approval.

  • Account actions: subscribe, unsubscribe, rate a video, post a top-level comment (these need a literal confirm: true).

Private viewing analysis (local only)

  • Import your Google Takeout YouTube history and get a profile and trend comparison between two date ranges. The data stays in a local SQLite file.

  • Save local curation allowlists and generate a finite, proposed queue. The server never applies a queue to your account.

Safety model

Write tools are built so an AI client cannot make a surprise change:

  1. Preflight. A youtube_preflight_* tool reads fresh state from YouTube, validates the request and returns an exact preview.

  2. Approve. A separate youtube_approve call (one tool for every kind of change), with confirm: true, binds approval to the profile, channel, target, requested change and fresh state. Approvals expire. They are stored locally, so an approved operation survives a server restart until it expires.

  3. Execute. The write tool runs only with the same approved inputs and confirm: true.

More guard rails, all from the code:

  • Viewer actions (youtube_subscribe, youtube_unsubscribe, youtube_rate_video), youtube_create_comment and the local curation and reset tools are single-step writes: no preflight, but they require a literal confirm: true.

  • Mutations are never retried automatically. Ambiguous outcomes are reconciled with a read.

  • Public visibility, scheduling, synthetic-media changes and banning an author need an explicit, elevated flag.

  • Comment deletion requires the comment to belong to your selected channel.

  • Caption downloads never overwrite an existing path or follow symbolic links.

  • Creator tools check that the signed-in Google account matches the channel ID you configured.

  • The automated tests never make a live mutation.

Full details are in docs/README.md.

Requirements

  • Node.js 22.13 or newer

  • A Google Cloud project with the YouTube Data API v3 enabled (and the YouTube Analytics API for the creator analytics tools)

  • A YouTube Data API key for public reads, and an OAuth desktop client for account and creator tools

Install in your AI agent

No npm publish is needed. Every route below runs the server from the prebuilt tarball attached to the GitHub release with npx -y https://github.com/pratikgh0se/youtube-mcp/releases/download/v0.3.3/youtube-mcp-0.3.3.tgz --transport stdio, except the Claude Desktop bundle, which carries its own copy. You need Node.js 22.13+ on your PATH for the npx routes. Create your Google credentials first with the beginner setup guide (short version: Google credentials). You need at least a YouTube Data API key.

Agent

One-line install

Claude Code

/plugin marketplace add pratikgh0se/youtube-mcp, then /plugin install youtube-mcp@youtube-mcp

Claude Desktop

Download the .mcpb from Releases and double-click it

Codex CLI

codex mcp add youtube-mcp -- npx -y https://github.com/pratikgh0se/youtube-mcp/releases/download/v0.3.3/youtube-mcp-0.3.3.tgz --transport stdio

Gemini CLI

gemini extensions install https://github.com/pratikgh0se/youtube-mcp

Antigravity CLI

Add the server to ~/.gemini/config/mcp_config.json

Cursor

Install button, or .cursor/mcp.json

VS Code / Copilot

Install button, or .vscode/mcp.json

Windsurf

Add the server to mcp_config.json

Cline

Add the server to cline_mcp_settings.json, or point Cline at llms-install.md

Zed

Add a context_servers entry

goose

goose configure, or config.yaml

Other agents

See AGENTS.md and configs/generic-stdio.json

Ready-made files for each client are in configs/. Use the placeholders as shown and never paste a real key into a file you commit.

The first launch downloads the prebuilt release tarball and installs its dependencies, which takes a few seconds on a normal connection. Later launches use npm's cache. To be safe against a client start-up timeout on a slow network, warm the cache once in a terminal first:

npx -y https://github.com/pratikgh0se/youtube-mcp/releases/download/v0.3.3/youtube-mcp-0.3.3.tgz --version

Claude Code

claude plugin marketplace add pratikgh0se/youtube-mcp
claude plugin install youtube-mcp@youtube-mcp

Or inside Claude Code: /plugin marketplace add pratikgh0se/youtube-mcp, then /plugin install youtube-mcp@youtube-mcp. Claude Code asks for your API key (stored in your OS credential store) and four more settings: OAuth client file, profile name and channel ID are required, and the state directory is optional (leave it blank to use ~/.youtube-mcp). The plugin only holds config. The server itself still runs through npx.

Claude Desktop

Download youtube-mcp-<version>.mcpb (one universal bundle for macOS, Windows and Linux) from GitHub Releases and double-click it. Claude Desktop shows an install dialog and asks for your API key. The bundle includes the server, so it needs no npx at run time.

Fallback if you prefer not to use the bundle: add configs/claude-desktop.json to claude_desktop_config.json and restart. The first start downloads the package, which can take a few seconds.

{
  "mcpServers": {
    "youtube-mcp": {
      "command": "npx",
      "args": ["-y", "https://github.com/pratikgh0se/youtube-mcp/releases/download/v0.3.3/youtube-mcp-0.3.3.tgz", "--transport", "stdio"],
      "env": { "YOUTUBE_API_KEY": "<your-youtube-api-key>" }
    }
  }
}

Codex CLI

codex mcp add youtube-mcp --env YOUTUBE_API_KEY=<your-youtube-api-key> -- npx -y https://github.com/pratikgh0se/youtube-mcp/releases/download/v0.3.3/youtube-mcp-0.3.3.tgz --transport stdio

That stores the key in ~/.codex/config.toml. To keep it out of the file, use configs/codex.toml instead. It forwards the variables from your shell with env_vars (Codex does not expand ${VAR}) and sets startup_timeout_sec = 180, because the default of 10 seconds is shorter than the first npx run.

[mcp_servers.youtube-mcp]
command = "npx"
args = ["-y", "https://github.com/pratikgh0se/youtube-mcp/releases/download/v0.3.3/youtube-mcp-0.3.3.tgz", "--transport", "stdio"]
env_vars = ["YOUTUBE_API_KEY"]
startup_timeout_sec = 180

Gemini CLI

gemini extensions install https://github.com/pratikgh0se/youtube-mcp

Gemini prompts for your API key (kept in the system keychain, required) and the OAuth client file, profile name and channel ID (needed for your channel's tools; see the setup guide). Change them later with gemini extensions config youtube-mcp. A plain settings.json entry is in configs/gemini-settings.json.

Note: Google stopped serving Gemini CLI to AI Pro, Ultra and free individual users on 2026-06-18. Paid API-key and enterprise users keep it (source). Everyone else should use Antigravity CLI below.

Antigravity CLI

Add this to ~/.gemini/config/mcp_config.json (global) or <workspace>/.agents/mcp_config.json. It is also in configs/antigravity.json.

{
  "mcpServers": {
    "youtube-mcp": {
      "command": "npx",
      "args": ["-y", "https://github.com/pratikgh0se/youtube-mcp/releases/download/v0.3.3/youtube-mcp-0.3.3.tgz", "--transport", "stdio"],
      "env": { "YOUTUBE_API_KEY": "<your-youtube-api-key>" }
    }
  }
}

Cursor

Install MCP Server

The button reads YOUTUBE_API_KEY from your shell environment. Or add configs/cursor.json to .cursor/mcp.json (or ~/.cursor/mcp.json). It uses ${env:YOUTUBE_API_KEY}, so no secret is written to the file.

VS Code / Copilot

Install in VS Code

The button installs the server without a key. Add one afterwards through the server's env, or use the file below, which prompts for it. From a terminal:

code --add-mcp '{"name":"youtube-mcp","type":"stdio","command":"npx","args":["-y","https://github.com/pratikgh0se/youtube-mcp/releases/download/v0.3.3/youtube-mcp-0.3.3.tgz","--transport","stdio"]}'

Or save configs/vscode.json as .vscode/mcp.json. VS Code asks for the key on first start (password: true) and stores it securely.

{
  "inputs": [
    { "type": "promptString", "id": "youtube-api-key", "description": "YouTube Data API v3 key", "password": true }
  ],
  "servers": {
    "youtube-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "https://github.com/pratikgh0se/youtube-mcp/releases/download/v0.3.3/youtube-mcp-0.3.3.tgz", "--transport", "stdio"],
      "env": { "YOUTUBE_API_KEY": "${input:youtube-api-key}" }
    }
  }
}

Windsurf

Use configs/windsurf.json (it reads ${env:YOUTUBE_API_KEY}). The current Devin docs put the file at ~/.config/devin/mcp_config.json (Windows: %APPDATA%\devin\mcp_config.json). The older path ~/.codeium/windsurf/mcp_config.json is what many guides still show. Only the first is confirmed by the vendor's docs, so if one does not load, try the other.

Cline

Open the MCP Servers panel, Configure, then "Configure MCP Servers", and add configs/cline.json. For Cline CLI the file is ~/.cline/data/settings/cline_mcp_settings.json. Cline does not document env interpolation, so the key goes in as a literal value in that file. You can also ask Cline to install it from llms-install.md.

Zed

Add configs/zed.json to your Zed settings (run the zed: open settings file action). Zed calls the map context_servers. The key goes in as a literal value.

goose

Run goose configure, choose Add Extension, then Command-Line Extension, and enter npx -y https://github.com/pratikgh0se/youtube-mcp/releases/download/v0.3.3/youtube-mcp-0.3.3.tgz --transport stdio with the key as an environment variable. Or add configs/goose.yaml to ~/.config/goose/config.yaml. The deeplink form (paste it into a browser or open) sets only the command, so add the key afterwards:

goose://extension?cmd=npx&arg=-y&arg=https%3A%2F%2Fgithub.com%2Fpratikgh0se%2Fyoutube-mcp%2Freleases%2Fdownload%2Fv0.3.3%2Fyoutube-mcp-0.3.3.tgz&arg=--transport&arg=stdio&id=youtube-mcp&name=YouTube%20MCP&description=Search%20YouTube%20and%20manage%20your%20channel%20with%20approval%20for%20every%20change

Other agents

Any client that launches stdio MCP servers can use configs/generic-stdio.json. Templates for OpenCode, OpenClaw and Hermes are in configs/ too. Agents installing this for a user should read AGENTS.md.

Account and creator tools: authorize once

Public tools need only the API key. For account and creator tools, add the OAuth client file, profile name and channel ID from step 2 to your client config, then run the one-time Google sign-in from a terminal with the same values:

YOUTUBE_OAUTH_CLIENT_SECRET_FILE=/absolute/path/to/client_secret.json \
YOUTUBE_MCP_PROFILE_ID=creator-main \
npx -y https://github.com/pratikgh0se/youtube-mcp/releases/download/v0.3.3/youtube-mcp-0.3.3.tgz youtube-auth

This opens a browser for Google consent on a local 127.0.0.1 callback and requests the youtube, youtube.force-ssl and yt-analytics.readonly scopes. The token is stored under ~/.youtube-mcp for that profile, and later calls refresh it silently. Run it again if you revoke access or the sign-in expires: it checks the stored sign-in with Google and only opens the browser when it no longer works. Add --force (youtube-auth --force) to always sign in again.

Google credentials

1. Create credentials

New to Google Cloud? Use the step-by-step beginner setup guide. The short version:

In the Google Cloud console:

  1. Create or pick a project, then enable YouTube Data API v3 and YouTube Analytics API.

  2. Create an API key. This is enough for the public tools.

  3. For account and creator tools, configure the OAuth consent screen (add yourself as a test user while the app is in testing), then create an OAuth client ID of type Desktop app and download its JSON file.

2. Set environment variables

Put these in your client config (see Install in your AI agent), or copy .env.example to .env (it is git-ignored) when running from a checkout. Never commit real values.

Variable

Needed for

Meaning

YOUTUBE_API_KEY

Public tools

Your YouTube Data API key.

YOUTUBE_OAUTH_CLIENT_SECRET_FILE

Account and creator tools

Absolute path to the Desktop OAuth client JSON.

YOUTUBE_MCP_PROFILE_ID

Creator tools

A name you choose, e.g. creator-main. Keeps local state separate per profile.

YOUTUBE_MCP_CHANNEL_ID

Creator tools

Your channel ID (starts with UC). The signed-in account must own it.

YOUTUBE_MCP_STATE_DIR

Optional

Where local state lives. Defaults to ~/.youtube-mcp. The Claude Code plugin and Gemini extension prompt for it (blank means the default). An empty value is treated as unset everywhere.

Run from a local checkout

For development, or to run without npx:

git clone https://github.com/pratikgh0se/youtube-mcp.git
cd youtube-mcp
npm ci
npm run build   # npm ci already builds via the prepare script
npm run auth    # one-time Google sign-in, same as the npx youtube-auth command

Point your client at the checkout with an absolute path:

{
  "mcpServers": {
    "youtube-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/youtube-mcp/bin/youtube-mcp.mjs", "--transport", "stdio"],
      "env": {
        "YOUTUBE_API_KEY": "your-api-key",
        "YOUTUBE_OAUTH_CLIENT_SECRET_FILE": "/absolute/path/to/client_secret.json",
        "YOUTUBE_MCP_PROFILE_ID": "creator-main",
        "YOUTUBE_MCP_CHANNEL_ID": "UC..."
      }
    }
  }
}

More templates (one per client) are in configs/. They launch the server with npx -y https://github.com/pratikgh0se/youtube-mcp/releases/download/v0.3.3/youtube-mcp-0.3.3.tgz --transport stdio. To use your checkout instead, change the command to node with the path above.

Optional: local HTTP

PORT=3000 node bin/youtube-mcp.mjs --transport http

This binds to 127.0.0.1 only. Do not expose it to the internet.

Example prompts

  • "Search YouTube for recent talks about the Model Context Protocol and summarise the top three."

  • "Get the transcript for this video and list the main points."

  • "Show my channel's top 10 videos for the last 90 days and where viewers drop off in the most recent one."

  • "Preview a private upload of /Users/me/videos/demo.mp4 titled 'Demo', and wait for me to approve it."

  • "Create a private playlist called 'To review' and add these five videos to it. Show me the preview first."

  • "List the unreplied comments on my latest video and draft replies for me to approve."

  • "Import my Takeout watch history and compare what I watched in January with what I watched in June."

Tools

79 tools, grouped by area. Tools marked "preflight and approve" need the three-step flow above.

Area

Tools

Public reads (7)

youtube_search (filters: order, publishedAfter/publishedBefore, videoDuration, channelId, regionCode, relevanceLanguage, safeSearch, pageToken; 100 quota units), youtube_trending (most popular videos by region and category, 1 unit), youtube_list_channel_videos (recent uploads with statistics for any channel ID or @handle, about 3 units per page), youtube_get_video, youtube_get_channel, youtube_get_comments, youtube_get_transcript

Your account (9)

Read: youtube_my_account, youtube_list_subscriptions (paginated; details: true adds subscriberCount, videoCount and lastUploadAt, costing about 1 extra quota unit per returned channel), youtube_list_channel_comment_threads. Write (confirm: true): youtube_subscribe, youtube_unsubscribe, youtube_rate_video, youtube_create_comment (only on videos your channel owns; other videos are refused with ownership_required). Bulk unsubscribe (preflight and approve): youtube_preflight_unsubscribe_many, youtube_unsubscribe_many (up to 100 subscriptions, 50 quota units each, per-item results: removed, already_gone, failed or unknown (uncertain outcome: reconcile with youtube_list_subscriptions); stops early on quota exhaustion)

Creator analytics (4)

youtube_creator_overview, youtube_creator_top_videos, youtube_creator_retention, youtube_creator_report (allowlisted YouTube Analytics report: choose metrics, dimensions, filters, sort; invalid combinations are rejected up front)

Channel profile (2)

youtube_preflight_update_channel, youtube_update_channel: edit your channel's description, keywords, country and default language (preflight and approve; other branding settings are preserved)

Creator reads (10)

youtube_list_owned_videos, youtube_get_owned_video, youtube_list_video_categories, youtube_list_playlists, youtube_get_playlist, youtube_list_playlist_items, youtube_list_caption_tracks, youtube_list_moderation_comments, youtube_get_moderation_comment, youtube_find_comment_reply

Uploads (7)

youtube_preflight_upload, youtube_upload_video, youtube_get_upload_status, youtube_preflight_resume_upload, youtube_resume_upload, youtube_preflight_cancel_upload, youtube_cancel_upload

Video metadata, archive and thumbnails (6)

youtube_preflight_update_metadata, youtube_update_metadata, youtube_preflight_archive_video, youtube_archive_video, youtube_preflight_set_thumbnail, youtube_set_thumbnail

Captions (7)

youtube_preflight_caption_upload, youtube_upload_caption, youtube_preflight_caption_update, youtube_update_caption, youtube_download_caption (no approval; writes a new file named by fileName into <state dir>/downloads/ and returns its path), youtube_preflight_caption_delete, youtube_delete_caption

Playlists (12)

youtube_preflight_create_playlist, youtube_create_playlist, youtube_preflight_update_playlist, youtube_update_playlist, youtube_preflight_delete_playlist, youtube_delete_playlist, youtube_preflight_add_playlist_item, youtube_add_playlist_item, youtube_preflight_remove_playlist_item, youtube_remove_playlist_item, youtube_preflight_reorder_playlist_item, youtube_reorder_playlist_item

Comments and moderation (6)

youtube_preflight_reply_to_comment, youtube_reply_to_comment, youtube_preflight_set_comment_moderation_status, youtube_set_comment_moderation_status, youtube_preflight_delete_comment, youtube_delete_comment

Approval (1)

youtube_approve: approves any pending preview by approvalId and shows its kind, target and exact change

Local viewing analysis (7)

youtube_import_takeout, youtube_consumption_profile, youtube_consumption_trends, youtube_save_curation_policy, youtube_save_curation_candidate, youtube_propose_consumption_queue, youtube_reset_consumption_data (watch events are kept unless includeWatchEvents is set; they are not per profile, so this deletes them for every profile sharing the state directory; irreversible)

Status (1)

youtube_auth_status

Privacy and security

  • The OAuth refresh token is stored on your machine under ~/.youtube-mcp (or YOUTUBE_MCP_STATE_DIR), in a file with user-only permissions.

  • Operation approvals, upload recovery state and your Takeout-derived SQLite database (consumption.sqlite) live in the same directory. The Takeout importer never sends data to YouTube.

  • Your Google credentials go only to Google's APIs. The public transcript tool uses the youtube-transcript package to fetch captions from YouTube.

  • The default transport is stdio. The optional HTTP transport binds to 127.0.0.1 only.

  • Never commit .env, your OAuth client JSON, token state or Takeout exports. The .gitignore already excludes .env files.

  • Running this server gives the AI client access to your YouTube account within the scopes you grant. Review each preview before approving it.

  • To report a vulnerability, follow SECURITY.md and use GitHub's private reporting. Please do not open a public issue.

Development

npm ci
npm run lint            # type check the source
npm run typecheck:tests # type check the tests
npm test                # vitest, fully offline (214 tests)
npm run build           # compile to dist/
npm run smoke:read-only # offline by default; set YOUTUBE_LIVE_SMOKE=1 with an API key for one live read
npm run dev:stdio       # run from source over stdio

Continuous integration (.github/workflows/verify.yml) runs the same checks on Node 22. See docs/CHANGELOG.md for what has changed.

Contributing

Issues and pull requests are welcome. Please run npm run lint, npm run typecheck:tests and npm test before opening a pull request, add tests for any behavior change, and keep write actions behind the preflight and approve flow. Never include real credentials, tokens or personal data in issues, tests or fixtures.

License

MIT (c) 2026 Pratik Ghose

Available Tools

79 tools
youtube_add_playlist_itemB
Destructive

Add a video to an approved owned playlist.

Inputs: videoId (required), approvalId (required), playlistId (required), confirm.

youtube_approveA
Destructive

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.

Inputs: approvalId (required), confirm.

youtube_archive_videoA
Destructive

Archive an approved owned video (private, not scheduled; reversible via youtube_update_metadata). Approve the preview with youtube_approve, then call with confirm: true.

Inputs: videoId (required), approvalId (required), confirm.

youtube_auth_statusB
Read-only

Report safe local YouTube authorization readiness.

Inputs: no named parameters.

youtube_cancel_uploadC
Destructive

Cancel an approved resumable upload session.

Inputs: uploadId (required), approvalId (required), confirm.

youtube_consumption_profileB
Read-only

Summarize local consumption analytics for a date range.

Inputs: endDate (required), startDate (required).

youtube_create_commentA
Destructive

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.

Inputs: text (required), videoId (required), confirm.

youtube_create_playlistC
Destructive

Create an approved creator playlist.

Inputs: title (required), approvalId (required), confirm, description, +1 more.

youtube_creator_overviewB
Read-only

Get owned-channel creator analytics for a date range.

Inputs: endDate (required), startDate (required).

youtube_creator_reportA
Read-only

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.

Inputs: metrics (required), sort, endDate, filters, +3 more.

youtube_creator_retentionB
Read-only

Get audience-retention data for an owned video.

Inputs: videoId (required).

youtube_creator_top_videosC
Read-only

Get top owned-channel videos for a date range.

Inputs: endDate (required), startDate (required), limit.

youtube_delete_captionB
Destructive

Delete an approved owned caption track.

Inputs: videoId (required), captionId (required), approvalId (required), confirm.

youtube_delete_commentB
Destructive

Delete an approved immutable creator-channel comment.

Inputs: commentId (required), approvalId (required), confirm.

youtube_delete_playlistA
Destructive

Delete an approved owned playlist.

Inputs: approvalId (required), playlistId (required), confirm.

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.

Inputs: videoId (required), fileName (required), captionId (required), format.

youtube_find_comment_replyB
Read-only

Exhaustively find an exact selected-channel reply under one immutable parent comment.

Inputs: text (required), parentId (required).

youtube_get_channelB
Read-only

Get a public YouTube channel by ID.

Inputs: channelId (required).

youtube_get_commentsA
Read-only

List public comment threads for a specific video.

Inputs: videoId (required), maxResults.

youtube_get_moderation_commentA
Read-only

Read one immutable comment by ID for exact moderation reconciliation.

Inputs: commentId (required).

youtube_get_owned_videoB
Read-only

Get a video owned by the selected creator profile.

Inputs: videoId (required).

youtube_get_playlistB
Read-only

Get one playlist owned by the selected creator profile.

Inputs: playlistId (required).

youtube_get_transcriptB
Read-only

Get a best-effort public transcript for a video.

Inputs: videoId (required).

youtube_get_upload_statusB
Read-only

Probe a resumable upload session without sending media bytes.

Inputs: uploadId (required).

youtube_get_videoB
Read-only

Get a public YouTube video by ID.

Inputs: videoId (required).

youtube_import_takeoutA

Import a local Google Takeout YouTube-history JSON or HTML file into local derived analytics.

Inputs: inputPath (required).

youtube_list_caption_tracksA
Read-only

List caption tracks for an owned creator video.

Inputs: videoId (required).

youtube_list_channel_comment_threadsA
Read-only

List comment threads associated with the authenticated channel; authors may be anyone.

Inputs: maxResults.

youtube_list_channel_videosA
Read-only

List recent uploads with statistics for ANY public channel, by channel ID or @handle (about 3 quota units per page).

Inputs: channelId (required), pageToken, maxResults.

youtube_list_moderation_commentsC
Read-only

List selected-channel moderation threads with available replies.

Inputs: pageToken, maxResults, moderationStatus.

youtube_list_owned_videosC
Read-only

List videos owned by the selected creator profile.

Inputs: pageToken, maxResults.

youtube_list_playlist_itemsA
Read-only

List items from an owned creator playlist.

Inputs: playlistId (required), pageToken, maxResults.

youtube_list_playlistsB
Read-only

List playlists owned by the selected creator profile.

Inputs: pageToken, maxResults.

youtube_list_subscriptionsA
Read-only

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.

Inputs: details, pageToken, maxResults.

youtube_list_video_categoriesB
Read-only

List available YouTube video categories with freshness metadata.

Inputs: id, regionCode.

youtube_my_accountB
Read-only

Get the authenticated YouTube channel.

Inputs: no named parameters.

youtube_preflight_add_playlist_itemC
Destructive

Read and preview adding a video to an owned playlist.

Inputs: videoId (required), playlistId (required).

youtube_preflight_archive_videoA
Destructive

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.

Inputs: videoId (required).

youtube_preflight_cancel_uploadC
Destructive

Preview cancellation of a resumable upload session.

Inputs: uploadId (required).

youtube_preflight_caption_deleteB
Destructive

Preview deletion of an owned caption track.

Inputs: videoId (required), captionId (required).

youtube_preflight_caption_updateB
Destructive

Validate and preview an owned caption update.

Inputs: name (required), videoId (required), filePath (required), language (required), +3 more.

youtube_preflight_caption_uploadC
Destructive

Validate and preview a caption upload for an owned video.

Inputs: name (required), videoId (required), filePath (required), language (required), +2 more.

youtube_preflight_create_playlistB
Destructive

Preview creation of a creator playlist; private is the default visibility.

Inputs: title (required), description, privacyStatus.

youtube_preflight_delete_commentC
Destructive

Read and preview deletion of an immutable creator-channel comment.

Inputs: commentId (required).

youtube_preflight_delete_playlistB
Destructive

Read and preview deletion of an owned playlist.

Inputs: playlistId (required).

youtube_preflight_remove_playlist_itemB
Destructive

Read and preview removal of an immutable playlist item.

Inputs: playlistId (required), playlistItemId (required).

youtube_preflight_reorder_playlist_itemC
Destructive

Read and preview reordering an immutable playlist item.

Inputs: position (required), playlistId (required), playlistItemId (required).

youtube_preflight_reply_to_commentC
Destructive

Read and preview a reply to an immutable creator-channel comment.

Inputs: text (required), commentId (required).

youtube_preflight_resume_uploadC
Destructive

Validate and preview an explicit resumable-upload continuation.

Inputs: title (required), filePath (required), uploadId (required), publish, +3 more.

youtube_preflight_set_comment_moderation_statusC
Destructive

Read and preview a comment moderation action; banning requires elevated intent.

Inputs: commentId (required), moderationStatus (required), elevated, banAuthor.

youtube_preflight_set_thumbnailC
Destructive

Validate and preview an owned-video thumbnail.

Inputs: videoId (required), filePath (required), mimeType (required).

youtube_preflight_unsubscribe_manyA
Destructive

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).

Inputs: subscriptionIds (required).

youtube_preflight_update_channelA
Destructive

Preview an edit to the selected creator channel profile (description, keywords, country, defaultLanguage), showing current vs desired. Other branding settings are preserved on execute.

Inputs: country, keywords, description, defaultLanguage.

youtube_preflight_update_metadataC
Destructive

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.

Inputs: videoId (required), tags, title, publish, +8 more.

youtube_preflight_update_playlistB
Destructive

Read and preview an update to an owned playlist.

Inputs: playlistId (required), title, description, privacyStatus.

youtube_preflight_uploadC
Destructive

Validate and preview a private resumable video upload.

Inputs: title (required), filePath (required), publish, publishAt, +2 more.

youtube_propose_consumption_queueC
Destructive

Create a finite selected-profile local consumption queue.

Inputs: minutes (required).

youtube_rate_videoC
Destructive

Rate a video for the authenticated account.

Inputs: rating (required), videoId (required), confirm.

youtube_remove_playlist_itemA
Destructive

Remove an approved immutable playlist item.

Inputs: approvalId (required), playlistId (required), playlistItemId (required), confirm.

youtube_reorder_playlist_itemB
Destructive

Reorder an item after an approved preview.

Inputs: position (required), approvalId (required), playlistId (required), playlistItemId (required), +1 more.

youtube_reply_to_commentB
Destructive

Reply to an approved immutable creator-channel comment.

Inputs: text (required), commentId (required), approvalId (required), confirm.

youtube_reset_consumption_dataA
Destructive

Delete selected-profile local curation policy, candidates, and queues.

Inputs: confirm.

youtube_resume_uploadA
Destructive

Resume an approved upload only after probing its existing session.

Inputs: title (required), filePath (required), uploadId (required), approvalId (required), +5 more.

youtube_save_curation_candidateC
Destructive

Save a selected-profile local curation candidate with source provenance.

Inputs: title (required), source (required), videoId (required), sourceId (required), +3 more.

youtube_save_curation_policyC
Destructive

Save selected-profile local curation allowlists and API-data retention.

Inputs: allowedSources (required), retentionDays.

youtube_set_comment_moderation_statusA
Destructive

Set an approved comment moderation status; banAuthor requires elevated intent.

Inputs: commentId (required), approvalId (required), moderationStatus (required), confirm, +2 more.

youtube_set_thumbnailB
Destructive

Set an approved thumbnail on an owned video.

Inputs: videoId (required), filePath (required), mimeType (required), approvalId (required), +1 more.

youtube_subscribeC
Destructive

Subscribe the authenticated account to a channel.

Inputs: channelId (required), confirm.

youtube_unsubscribeB
Destructive

Remove an authenticated-account subscription.

Inputs: subscriptionId (required), confirm.

youtube_unsubscribe_manyA
Destructive

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.

Inputs: approvalId (required), subscriptionIds (required), confirm.

youtube_update_captionC
Destructive

Update an approved owned caption track.

Inputs: name (required), videoId (required), filePath (required), language (required), +5 more.

youtube_update_channelA
Destructive

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.

Inputs: approvalId (required), confirm, country, keywords, +2 more.

youtube_update_metadataA
Destructive

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.

Inputs: videoId (required), approvalId (required), tags, title, +10 more.

youtube_update_playlistC
Destructive

Update an approved owned playlist.

Inputs: approvalId (required), playlistId (required), title, confirm, +2 more.

youtube_upload_captionA
Destructive

Upload an approved caption file without returning media bytes.

Inputs: name (required), videoId (required), filePath (required), language (required), +4 more.

youtube_upload_videoB
Destructive

Start an approved resumable video upload. Public visibility also needs publish: true.

Inputs: title (required), filePath (required), approvalId (required), confirm, +4 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    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

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to manage YouTube channels directly, including video publishing, SEO optimization, playlist curation, community interaction, and traffic analytics, all through local OAuth.
      2
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to read transcripts of any public video, research channels, analyze performance, read comments, and manage multiple owned channels.
      16
      74 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to interact with YouTube channels, providing analytics, video metadata updates, transcript extraction, and comment management through official Google APIs with OAuth 2.0.
      MIT