Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

YouTube MCP

by pratikgh0seversion 0.3.3i★ 1iRuns on your computerRepository ↗
Registry nameio.github.pratikgh0se/youtube-mcp

How to install

What it does

Search YouTube, manage your channel and read analytics; every change needs your approval.

  • Connects Runs on your computer
  • Account or key Needs YOUTUBE_API_KEY · 3 settings to fill in (YOUTUBE_OAUTH_CLIENT_SECRET_FILE, YOUTUBE_MCP_PROFILE_ID, YOUTUBE_MCP_CHANNEL_ID)
  • Category Marketing & social media

Use together with

Skills that teach the AI this kind of work; they work alongside this one

scroll-world

A skill that turn any brand into a scrollable 3D world landing page

by oso95★ 11,0551 skills

Skill · How-to guide

social-auto-upload

自动化上传视频到社交媒体:抖音、小红书、视频号、tiktok、youtube、bilibili

by dreammis★ 16,657 (whole repo)4 skills

Skill · How-to guide

native-subtitle-quote-image

保留视频内嵌字幕,精确取帧并生成 3:4 社交长图的 Agent Skill

by chengyi-ai★ 2,8881 skills

Skill · How-to guide

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity4/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness12/12Full marks for a release or code change within 30 days
Still answering0/8The cloud endpoint answered at the last check
Usage score16/100

Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Passed 3/3 checks · Runs on your computer

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude, with some setup first

No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

  1. Download the maker’s installer

    Download the maker’s .mcpb file

    The .mcpb file comes straight from the maker; we do not change it

  2. Double-click the file, then click Install in the Claude desktop app

  3. Try it

    Use YouTube MCP and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using YouTube MCP or shows a YouTube MCP tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect YouTube MCP yet

YouTube MCP runs on your computer, but ChatGPT can only connect servers that run on the web

What you can do instead

A · Use an app that can connect YouTube MCP

  • No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

B · Others in Marketing & social media that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Claude Code cannot connect YouTube MCP yet

The maker only provides an installer for the Claude desktop app

What you can do instead

A · Use an app that can connect YouTube MCP

  • No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

Cursor cannot connect YouTube MCP yet

The maker only provides an installer for the Claude desktop app

What you can do instead

A · Use an app that can connect YouTube MCP

  • No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

VS Code cannot connect YouTube MCP yet

The maker only provides an installer for the Claude desktop app

What you can do instead

A · Use an app that can connect YouTube MCP

  • No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

JSON settings are under “For developers” below

Stuck? Ask people who use YouTube MCP💬 Discussion →
For developers: Terminal commands and JSON settings

Values you fill in

  • YOUTUBE_API_KEY secret required env
    YouTube Data API v3 key for public search, video, channel, comment and transcript tools.
  • YOUTUBE_OAUTH_CLIENT_SECRET_FILE required env
    Path to the Desktop OAuth client JSON from Google Cloud, used to sign in to your channel.
  • YOUTUBE_MCP_PROFILE_ID required env
    Short profile name you choose (e.g. my-channel); keeps local state separate per channel.
  • YOUTUBE_MCP_CHANNEL_ID required env
    Your channel ID (starts with UC); the signed-in Google account must own it.
  • YOUTUBE_MCP_STATE_DIR env
    Directory for sign-in token, approvals and history. Defaults to ~/.youtube-mcp.

Descriptions are as written by the maker.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
Not on npm/PyPI
Connection
Runs on your computer
Latest versioni
0.3.3
Published to registryi
Nov 8, 2026
Code last changedi
Nov 8, 2026
Maker
pratikgh0se
Packages
mcpb: …/youtube-mcp-0.3.3.mcpb
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account pratikgh0se, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed 11 days ago

  • ✓ Pass

    Has a licence

    Uses MIT

  • – Not applicable

    Endpoint responds

    This one runs on your computer; there is no internet endpoint

  • – Not applicable

    Sign-in with OAuth

    Runs on your computer and uses local settings instead

  • … Not checked yet

    No hidden instructions in tool descriptions

    Runs on your computer; we can only read tool lists from internet endpoints

Published vulnerabilities (OSV.dev)

Not checked: only npm and PyPI packages with a version can be checked

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/pratikgh0se-youtube-mcp.svg)](https://mcp.popnx.com/en/servers/pratikgh0se-youtube-mcp)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Marketing & social mediai

  • More stars than 86% of the other 4175 servers in this category
  • Published to the registry more recently than 75% of the other 4175 servers in this category
  • Basic checks equal to or better than 99% of the other 4175 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is YouTube MCP safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: YOUTUBE_API_KEY

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed 11 days ago, and the latest version (0.3.3) reached the registry 11 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need MCPB on your computer.

What can I use instead?

In the same category: Relaticle, ChatbotX, X (Twitter) MCP Server by Xquik, Betterlytics, BibiGPT YouTube Video Summarizer

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

ChatbotX

Omnichannel customer messaging, CRM contacts, flows, sequences, broadcasts, and AI automation.

by ChatbotXIOGrowing★ 1.1K Stars for the whole repoUpdated 13 days ago

Runs in the cloud✓ service owner · chatbotx.io

Betterlytics

Query your Betterlytics web analytics from AI agents: traffic, funnels, journeys, errors, uptime.

by betterlyticsGrowing★ 196Updated 4 months ago

Runs in the cloud✓ service owner · betterlytics.io
Compared with similar ones
This one
YouTube MCP
RelaticleChatbotXX (Twitter) MCP Server by XquikBetterlyticsBibiGPT YouTube Video Summarizer
Runs whereInstalls on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to install
Needs a keyYesNoNoNoYesNo
Add with + in ClaudeNoNoNoNoNoNo
Basic checks3/34/44/44/44/44/4
LicenseMITAGPL-3.0NOASSERTIONMITAGPL-3.0MIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

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.

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

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.

AgentOne-line install
Claude Code/plugin marketplace add pratikgh0se/youtube-mcp, then /plugin install youtube-mcp@youtube-mcp
Claude DesktopDownload the .mcpb from Releases and double-click it
Codex CLIcodex 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 CLIgemini extensions install https://github.com/pratikgh0se/youtube-mcp
Antigravity CLIAdd the server to ~/.gemini/config/mcp_config.json
CursorInstall button, or .cursor/mcp.json
VS Code / CopilotInstall button, or .vscode/mcp.json
WindsurfAdd the server to mcp_config.json
ClineAdd the server to cline_mcp_settings.json, or point Cline at llms-install.md
ZedAdd a context_servers entry
goosegoose configure, or config.yaml
Other agentsSee 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- .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": " " } } } }

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 /.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": " " } } } }

Cursor

The button reads YOUTUBE_API_KEY from your shell environment. Or add configs/cursor.json to .cursor/mcp.json (

Only the beginning is shown; read the rest in the repo