youtube-channel-mcp
Advanced tools
MCP server for YouTube — analytics, video metadata, SEO updates. Read your private channel data and update titles/descriptions/tags directly from Claude. OAuth2, 10 tools, works with Claude Desktop + Claude Code.
Connect Claude to your YouTube channel. Read analytics, fetch full video metadata (including unlisted/private/draft), search your uploads, and update titles/descriptions/tags — all from Claude Desktop, Claude Code, or any MCP client.
A Model Context Protocol (MCP) server that connects Claude to the YouTube Data API v3 and YouTube Analytics API via OAuth2.
Instead of copying data from YouTube Studio into AI tools, just ask Claude:
Claude reads your real private channel data and can update video SEO directly.
Claude → YouTube MCP Server → YouTube APIs → Your Channel Data
(you) (this repo) (OAuth2) (stays local)
Everything runs on YOUR machine. Read + Write access. Nothing sent to third parties.
| Tool | What It Does |
|---|---|
get_video_details | Full metadata for any video by ID or URL — title, full description, all tags, category, privacy status (public/unlisted/private/draft), stats, duration, thumbnail URL |
search_my_videos | Search your own channel's videos by keyword. Returns metadata + stats for matching videos |
update_video_seo | Update title, description, and/or tags on any video directly. Only changes fields you provide |
| Tool | What It Does |
|---|---|
get_channel_overview | Subscribers, total views, video count, channel description, creation date |
get_all_videos | List all videos with stats (views, likes, comments, tags, privacy status). Sort by date or views |
get_analytics_over_time | Day-by-day views, watch time, subscribers gained/lost for any date range |
get_top_videos_analytics | Top performing videos ranked by views with retention %, watch time, subs gained |
get_audience_demographics | Audience breakdown: top countries, device types, age groups, gender |
get_traffic_sources | Where viewers come from: YouTube Search, Suggested, Browse, External, Direct |
analyze_and_suggest_topics | Pulls channel + top video data for AI-powered topic analysis |
npx youtube-studio-mcp
npm install -g youtube-studio-mcp
git clone https://github.com/adityaarsharma/youtube-studio-mcp.git
cd youtube-studio-mcp
npm install
cd into the foldernpm installYouTube MCP)YouTube MCP), your emailcredentials.jsonnode auth.js
Browser opens → log in with the Google account that owns your YouTube channel → Allow.
"This app isn't verified" warning is normal for personal apps. Click Advanced → Go to YouTube MCP (unsafe).
Edit ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"youtube-analytics": {
"command": "node",
"args": ["/full/path/to/youtube-studio-mcp/server.js"]
}
}
}
Or if installed via npm:
{
"mcpServers": {
"youtube-analytics": {
"command": "npx",
"args": ["-y", "youtube-studio-mcp"]
}
}
}
claude mcp add youtube-analytics node /full/path/to/youtube-studio-mcp/server.js
Add to .vscode/settings.json:
{
"mcp.servers": {
"youtube-analytics": {
"command": "npx",
"args": ["-y", "youtube-studio-mcp"]
}
}
}
Restart Claude. Done!
Get the full details for this video: [paste URL or ID]
Check what keywords it's ranking for and suggest optimized title + tags
Pull my channel overview, top 20 videos by watch time, 90-day analytics,
traffic sources and audience demographics. Give me a full performance report.
Get my top 20 videos by watch time. What patterns do you see —
topics, lengths, title styles? Suggest 10 new video ideas.
Search my videos for "elementor menu". Pull the full details.
Write an optimized title, description, and tags — then update it.
Show my full audience demographics — age, gender, countries, devices.
What content style and posting schedule fits my actual audience?
Get all my videos. Compare bottom 10 vs top 10 by views.
Why did the lower ones underperform? What would you change?
This repo includes ready-to-use AI skill files in the skills/ folder that supercharge your YouTube workflow. Each skill is a structured prompt that makes Claude act as a specialized team member.
Install any skill: Copy the .md file into your Claude skills directory and it activates automatically.
| Skill | What It Does | Trigger Phrases |
|---|---|---|
| SEO Optimizer | Optimizes titles, descriptions, tags. Protects existing ranking keywords. 3 title options + full description + 20 tags | "optimize this video", "write title", "write tags" |
| Channel Audit | Full channel health report — views, subs, retention, traffic sources, audience demographics. Identifies problems and prescribes fixes | "audit my channel", "why am I not growing", "channel report" |
| Topic Finder | 12 data-backed video topics with keyword volumes, SERP gaps, and competitor analysis. Tier 1/2/3 prioritization | "video ideas", "what should I make next", "find topics" |
| Thumbnail Auditor | 20-point thumbnail scoring (66-point scale). Grades A-F with specific redesign instructions | "audit thumbnail", "review this thumbnail", "CTR is low" |
| Script Writer | Full production-ready scripts with word-for-word narration, screen cues, timestamps, editor brief, and companion Short script | "write script", "video script", "tutorial script" |
| Competitor Spy | Competitor channel analysis, SERP battle maps, 10 "steal-worthy" topics with differentiation angles | "competitor analysis", "who's beating me", "content gaps" |
| Video Analyzer | Deep single-video analysis — SEO score (21-point), performance benchmarks, and optimized rewrite | "analyze this video", "why isn't this performing", "video audit" |
| Shorts Repurposer | Turn any long-form video into 3-5 Shorts with hooks, text overlays, and posting strategy | "make shorts from this", "repurpose video", "extract shorts" |
You: "Optimize this video: youtube.com/watch?v=abc123"
Claude:
1. youtube-seo-optimizer skill activates
2. Calls get_video_details → pulls current title, description, tags
3. Checks YouTube SERP for current rankings
4. Lists PROTECTED keywords (won't remove)
5. Writes 3 new title options + full description + 20 tags
6. Can call update_video_seo to apply changes directly
The skills tell Claude what to do. The MCP tools give Claude access to your data. Together they create a complete YouTube AI workflow.
Claude Desktop / Claude Code:
# Copy a skill to your Claude skills directory
cp skills/youtube-seo-optimizer.md ~/.claude/skills/
Or install all 8:
cp skills/youtube-*.md ~/.claude/skills/
| Scope | Purpose |
|---|---|
youtube | Read + write video metadata (titles, descriptions, tags) |
youtube.readonly | Read video data, search, list |
yt-analytics.readonly | Read private analytics (views, watch time, subs, demographics) |
youtubepartner-channel-audit | Extended channel audit data |
To enable write access (update_video_seo), delete tokens.json and re-run node auth.js. The new auth flow requests the youtube write scope.
| Question | Answer |
|---|---|
| Does my data go to any server? | No — runs 100% on your machine |
| Can it delete videos? | No — only reads data and updates metadata |
| Is OAuth safe? | Yes — same system used by TubeBuddy, VidIQ |
| Can I revoke access? | Yes — anytime at myaccount.google.com/permissions |
Never commit credentials.json or tokens.json to git.
| Problem | Fix |
|---|---|
credentials.json not found | Download from Google Cloud Console → move to repo folder |
Not authenticated | Run node auth.js |
| Port 3000 in use | lsof -ti:3000 | xargs kill -9 then retry |
| Claude doesn't show tools | Check JSON syntax in config, restart Claude fully |
| "App isn't verified" | Click Advanced → Go to YouTube MCP (unsafe) |
update_video_seo fails | Delete tokens.json, re-run node auth.js for write scope |
| Quota exceeded | YouTube API free limit: 10,000 units/day. Wait 24h |
npx youtube-studio-mcp for zero-installget_video_details — Full metadata by video ID or URL. Works for public, unlisted, private, and draft videossearch_my_videos — Search your own uploads by keywordupdate_video_seo — Update title, description, tags directly on YouTubeyoutube scope for SEO updatesyoutube-studio-mcp/
├── server.js ← MCP server (10 tools)
├── auth.js ← Run once to link YouTube account
├── package.json ← Dependencies + npm config
├── skills/ ← 8 AI skills for YouTube creators
├── LICENSE ← MIT
├── credentials.json ← YOU add this (never commit!)
└── tokens.json ← Auto-created after auth (never commit!)
PRs welcome! Ideas:
MIT — free to use, modify, share.
Aditya Sharma — Building AI tools for creators and marketers.
If this saved you time — star the repo and share with a creator friend!
FAQs
MCP server for YouTube — analytics, video metadata, SEO updates. Read your private channel data and update titles/descriptions/tags directly from Claude. OAuth2, 10 tools, works with Claude Desktop + Claude Code.
The npm package youtube-channel-mcp receives a total of 0 weekly downloads. As such, youtube-channel-mcp popularity was classified as not popular.
We found that youtube-channel-mcp demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Security News
Anthropic’s free OSS Scanner uses Mythos and other Claude models to find open source vulnerabilities and send maintainers reports with proposed fixes.
Security News
On Front Lines’ Early Adopters: CISO podcast, Andrew Becherer shares lessons from Datadog, weighs the long-term costs of AI-built tools, and explains how founders can actually gain a CISO’s trust.
Security News
/Product
Socket for Origin scans dependency changes in pull requests and flags security risks based on your team’s policies. Now available in Cursor’s App Marketplace.