{"_id":"@joinhackyard/youtube-channel-mcp","_rev":"4-060f953414dec49a95bf58416e6c5ffd","name":"@joinhackyard/youtube-channel-mcp","dist-tags":{"latest":"1.1.0"},"versions":{"0.0.0-stage":{"name":"@joinhackyard/youtube-channel-mcp","version":"0.0.0-stage","_id":"@joinhackyard/youtube-channel-mcp@0.0.0-stage","stub":true,"maintainers":[{"name":"shyamol","email":"hello@hackyard.org"}],"dist":{"shasum":"b88f94a39388c2b3e3661665e53b0a5220a5fcdd","tarball":"https://registry.npmjs.org/@joinhackyard/youtube-channel-mcp/-/youtube-channel-mcp-0.0.0-stage.tgz","fileCount":2,"integrity":"sha512-fg5fp4twx+3OEx/WI9mrdmaXFDbZLxtsM3cD0Lq1vjWjxeqWSIYtlsORDCK7IeONuA4LqdCHIiRsOCBObkVT4Q==","signatures":[{"sig":"MEUCIAzX1uHUZ42KqbdUc4/6Z3+l7WOZFrAkyEmESNK6yVagAiEA1HELZ89kqZuZVha2eJqfJH6TzNSfzUefTyyggOKj5+k=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":355},"_npmUser":{"name":"shyamol","email":"hello@hackyard.org"},"description":"Temporary package placeholder for staged publishing","directories":{}},"1.0.0":{"name":"@joinhackyard/youtube-channel-mcp","version":"1.0.0","keywords":["mcp","model-context-protocol","mcp-server","youtube","youtube-api","youtube-analytics","youtube-channel","youtube-upload","youtube-comments","claude","hermes","cursor","ai-agent"],"author":{"url":"https://hackyard.org","name":"Hackyard"},"license":"MIT","_id":"@joinhackyard/youtube-channel-mcp@1.0.0","maintainers":[{"name":"shyamol","email":"hello@hackyard.org"}],"homepage":"https://github.com/joinhackyard/youtube-channel-mcp#readme","bugs":{"url":"https://github.com/joinhackyard/youtube-channel-mcp/issues"},"bin":{"youtube-channel-mcp":"dist/src/cli.js"},"dist":{"shasum":"7488ec5d534ee1a81a69011a13fbed483bd775ee","tarball":"https://registry.npmjs.org/@joinhackyard/youtube-channel-mcp/-/youtube-channel-mcp-1.0.0.tgz","fileCount":61,"integrity":"sha512-+v0ZajK1VcSscQRz8yLVXfxxhkre0KkcNCWIzB5SJkRo8we7vpk388qXpICq1/u4DFJakkeNiMaMeHzcbNAo+A==","signatures":[{"sig":"MEUCIDqiosAIlX40T2wDhDtmsQVNjNQFoI348fI30qMr9NovAiEA2uRy200EZ9m2q0LsVNHwaAtd3J/fssKLzzLuF7DJdRA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIEBFXOVvSQ7uj7fbuAX/tXmje8Rx2P8Xj3edxllNPsZFAiEAhC3AdnjROcuZ1k6bhO+tkn9VWMsixu8mlmYI++kTTqE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":479474},"type":"module","_from":"file:joinhackyard-youtube-channel-mcp-1.0.0.tgz","engines":{"node":">=22.13"},"scripts":{"test":"npm run build && node --test --test-force-exit --test-timeout=60000 --test-concurrency=1 \"dist/test/*.test.js\"","build":"tsc -p tsconfig.json","start":"node dist/src/cli.js","typecheck":"tsc -p tsconfig.json --noEmit","prepublishOnly":"npm test"},"_npmUser":{"name":"shyamol","email":"hello@hackyard.org"},"_resolved":"/private/tmp/ycm-release/joinhackyard-youtube-channel-mcp-1.0.0.tgz","_integrity":"sha512-+v0ZajK1VcSscQRz8yLVXfxxhkre0KkcNCWIzB5SJkRo8we7vpk388qXpICq1/u4DFJakkeNiMaMeHzcbNAo+A==","repository":{"url":"git+https://github.com/joinhackyard/youtube-channel-mcp.git","type":"git"},"_npmVersion":"10.9.8","description":"MCP server to run your whole YouTube channel from Claude, Hermes, Cursor, Codex and any MCP client: uploads, scheduling, metadata, thumbnails, playlists, captions, comments, channel branding and analytics, on the official YouTube APIs.","directories":{},"_nodeVersion":"22.23.1","dependencies":{"zod":"^4.3.6","@googleapis/youtube":"^40.0.2","google-auth-library":"^11.3.3","@modelcontextprotocol/sdk":"^1.32.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.9.3","@types/node":"^22.19.0"},"optionalDependencies":{"@napi-rs/keyring":"^2.1.2"},"_npmOperationalInternal":{"tmp":"tmp/youtube-channel-mcp_1.0.0_1793971944745_0.004619524159560684","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@joinhackyard/youtube-channel-mcp","version":"1.0.1","keywords":["mcp","model-context-protocol","mcp-server","youtube","youtube-api","youtube-analytics","youtube-channel","youtube-upload","youtube-comments","claude","hermes","cursor","ai-agent"],"author":{"url":"https://hackyard.org","name":"Hackyard"},"license":"MIT","_id":"@joinhackyard/youtube-channel-mcp@1.0.1","maintainers":[{"name":"shyamol","email":"hello@hackyard.org"}],"homepage":"https://github.com/joinhackyard/youtube-channel-mcp#readme","bugs":{"url":"https://github.com/joinhackyard/youtube-channel-mcp/issues"},"bin":{"youtube-channel-mcp":"dist/src/cli.js"},"dist":{"shasum":"a794852a76e2c06f8eb2ba4093e6bc608c2b7f39","tarball":"https://registry.npmjs.org/@joinhackyard/youtube-channel-mcp/-/youtube-channel-mcp-1.0.1.tgz","fileCount":61,"integrity":"sha512-ol4JdGEp+fG6la6ftNTiKSN4Ju12Rau7DyOM7Sx70DGv9FOtwoy3GQY96nx3/PB7Y6enAMkJo1rO7YzUPGPxoQ==","signatures":[{"sig":"MEUCIGOD1xhUu2lZ/GNn3GJaFgB4cgDyNJEgDYfbHQpnA51RAiEA9yOVz4DZeir3gCP4AWFiNgc8hkVQbFJO5JWLWMzYeJo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCID6LHhif2TxKF5rvZxuyt808O9zQv0sA2ts8wHsFPdNgAiEAg6vzzzqWylpt2NjYWbvxwYVS8piMBb97+bfib8owrIA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@joinhackyard%2fyoutube-channel-mcp@1.0.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":483204},"type":"module","engines":{"node":">=22.13"},"gitHead":"3b05c2640fb4b2e8f79ed44ca4cd9f56ce0178e5","scripts":{"test":"npm run build && node --test --test-force-exit --test-timeout=60000 --test-concurrency=1 \"dist/test/*.test.js\"","build":"tsc -p tsconfig.json","start":"node dist/src/cli.js","format":"prettier --write .","typecheck":"tsc -p tsconfig.json --noEmit","format:check":"prettier --check .","prepublishOnly":"npm test"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"d29fcb20-9d5e-49ff-9dae-88baa4cd1e75"}},"repository":{"url":"git+https://github.com/joinhackyard/youtube-channel-mcp.git","type":"git"},"_npmVersion":"12.2.2","description":"MCP server to run your whole YouTube channel from Claude, Hermes, Cursor, Codex and any MCP client: uploads, scheduling, metadata, thumbnails, playlists, captions, comments, channel branding and analytics, on the official YouTube APIs.","directories":{},"_nodeVersion":"24.22.2","dependencies":{"zod":"^4.3.6","@googleapis/youtube":"^40.0.2","google-auth-library":"^11.3.3","@modelcontextprotocol/sdk":"^1.32.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"prettier":"^3.9.10","typescript":"^5.9.3","@types/node":"^22.19.0"},"optionalDependencies":{"@napi-rs/keyring":"^2.1.2"},"_npmOperationalInternal":{"tmp":"tmp/youtube-channel-mcp_1.0.1_1793972578183_0.6842913269602849","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"_id":"@joinhackyard/youtube-channel-mcp@1.1.0","bin":{"youtube-channel-mcp":"dist/src/cli.js"},"bugs":{"url":"https://github.com/joinhackyard/youtube-channel-mcp/issues"},"dist":{"shasum":"74ce993d6005f3b7f5948ec92a638ae55cdf2ad5","tarball":"https://registry.npmjs.org/@joinhackyard/youtube-channel-mcp/-/youtube-channel-mcp-1.1.0.tgz","fileCount":83,"integrity":"sha512-1PmGYeiYqnWOBNQE+rCyui7JZZsn0k9LQ9Vz27w47Ekf4W7Qkl3lZif7r13liDCKbp3J/lMbE4ETnFD7xUVF0A==","signatures":[{"sig":"MEYCIQDWl+hgOEFjMR37smUYG7X5dHEX15y2nXpD0O4M+Trl5AIhAKAz/umYLR6L1Ewm0dWbTwUhtrpIGhqrS+dRxOwOQikN","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQD1vDE0rL1HWWSme7n3oyvmzT5da/jD7KVjHGr7ms3G9wIhAO0DWUP3T1bUmLn4am3LOlMAlEn1XBXz3FGJ3pNFDTQa"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@joinhackyard%2fyoutube-channel-mcp@1.1.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":801683},"name":"@joinhackyard/youtube-channel-mcp","type":"module","author":{"url":"https://hackyard.org","name":"Hackyard"},"engines":{"node":">=22.13"},"gitHead":"4f6c5a2713359f6bf696a9b5aa5ba71abdad020c","license":"MIT","scripts":{"test":"npm run build && node --test --test-force-exit --test-timeout=60000 --test-concurrency=1 \"dist/test/*.test.js\"","build":"tsc -p tsconfig.json","start":"node dist/src/cli.js","format":"prettier --write .","typecheck":"tsc -p tsconfig.json --noEmit","format:check":"prettier --check .","prepublishOnly":"npm test"},"version":"1.1.0","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"d29fcb20-9d5e-49ff-9dae-88baa4cd1e75"}},"homepage":"https://github.com/joinhackyard/youtube-channel-mcp#readme","keywords":["mcp","model-context-protocol","mcp-server","youtube","youtube-api","youtube-analytics","youtube-channel","youtube-upload","youtube-comments","claude","hermes","cursor","ai-agent","ab-testing","youtube-seo","youtube-growth","anthropic","openai","azure-openai","gemini"],"repository":{"url":"git+https://github.com/joinhackyard/youtube-channel-mcp.git","type":"git"},"_npmVersion":"12.2.2","description":"MCP server to run and grow your whole YouTube channel from Claude, Hermes, Cursor, Codex and any MCP client: uploads, scheduling, A/B tests, analytics, SEO, comments, Shorts, thumbnails and AI providers (Claude, OpenAI, Azure OpenAI, Gemini, OpenRouter, G","directories":{},"maintainers":[{"name":"shyamol","email":"hello@hackyard.org"}],"_nodeVersion":"24.22.2","dependencies":{"zod":"^4.3.6","openai":"^7.53.0","@google/genai":"^3.0.0","@anthropic-ai/sdk":"^1.6.0","@googleapis/youtube":"^40.0.2","google-auth-library":"^11.3.3","@modelcontextprotocol/sdk":"^1.32.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"prettier":"^3.9.10","typescript":"^7.0.2","@types/node":"^22.19.0"},"optionalDependencies":{"@napi-rs/keyring":"^2.1.2"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/youtube-channel-mcp_1.1.0_1793986233225_0.313544304052637"}}},"time":{"created":"2026-11-06T13:29:15.748Z","modified":"2026-11-06T17:30:33.740Z","0.0.0-stage":"2026-11-06T13:29:15.748Z","1.0.0":"2026-11-06T13:32:24.871Z","1.0.1":"2026-11-06T13:42:58.287Z","1.1.0":"2026-11-06T17:30:33.337Z"},"bugs":{"url":"https://github.com/joinhackyard/youtube-channel-mcp/issues"},"author":{"url":"https://hackyard.org","name":"Hackyard"},"license":"MIT","homepage":"https://github.com/joinhackyard/youtube-channel-mcp#readme","keywords":["mcp","model-context-protocol","mcp-server","youtube","youtube-api","youtube-analytics","youtube-channel","youtube-upload","youtube-comments","claude","hermes","cursor","ai-agent","ab-testing","youtube-seo","youtube-growth","anthropic","openai","azure-openai","gemini"],"repository":{"url":"git+https://github.com/joinhackyard/youtube-channel-mcp.git","type":"git"},"description":"MCP server to run and grow your whole YouTube channel from Claude, Hermes, Cursor, Codex and any MCP client: uploads, scheduling, A/B tests, analytics, SEO, comments, Shorts, thumbnails and AI providers (Claude, OpenAI, Azure OpenAI, Gemini, OpenRouter, G","maintainers":[{"name":"shyamol","email":"hello@hackyard.org"}],"readme":"# YouTube Channel MCP\n\n[![npm](https://img.shields.io/npm/v/@joinhackyard/youtube-channel-mcp?color=2b5ce4)](https://www.npmjs.com/package/@joinhackyard/youtube-channel-mcp)\n[![CI](https://github.com/joinhackyard/youtube-channel-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/joinhackyard/youtube-channel-mcp/actions/workflows/ci.yml)\n[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/joinhackyard/youtube-channel-mcp/badge)](https://scorecard.dev/viewer/?uri=github.com/joinhackyard/youtube-channel-mcp)\n[![License: MIT](https://img.shields.io/badge/license-MIT-2b5ce4)](LICENSE)\n[![Node](https://img.shields.io/node/v/@joinhackyard/youtube-channel-mcp?color=2b5ce4)](https://nodejs.org)\n\nRun and grow your whole YouTube channel from Claude, Hermes, Cursor, Codex, Windsurf or any MCP client. Upload and schedule videos, A/B test titles and thumbnails, diagnose why a video under-performs, find outliers and breakout topics, cut Shorts, design thumbnails, write metadata, answer comments, and manage playlists, captions and the channel profile.\n\n> “Upload `~/Videos/ep12.mp4` with chapters from the transcript, add it to the Podcast playlist and schedule it for Friday 6 pm.”\n> “Which videos brought in the most subscribers this month, and where did the views come from?”\n> “Show me comments held for review and reply to the questions.”\n\nIt runs on your own computer, talks only to the **official YouTube Data API v3 and YouTube Analytics API**, and keeps your Google sign-in in your **OS keychain**. No browser automation, no cookies, no third-party server.\n\n```bash\nnpx @joinhackyard/youtube-channel-mcp setup\n```\n\nSetup takes about five minutes: it walks you through creating your Google credentials, connects your channel, and adds itself to the AI apps it finds on your machine.\n\n## What it covers\n\n| Area                    |                                                                                                                                                                                                                                                                                  |\n| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| **Publishing**          | Upload local files or public URLs with resumable 16 MB chunks, checkpointed to disk: a dropped connection or closed app resumes from the last byte YouTube confirmed. Private, unlisted, public or scheduled (`publish_at`). Thumbnail, playlists and captions in the same call. |\n| **Videos**              | List everything on the channel (including private and scheduled), edit title, description, tags, category, languages, audience and AI-content disclosure, translate titles and descriptions, publish, unlist, schedule, delete.                                                  |\n| **A/B testing**         | Test up to 3 alternative titles, thumbnails or descriptions against the live version: daily rotation in balanced random order, trend-adjusted significance test, winner applied automatically. Start one from `upload_video` or on any live video.                               |\n| **Growth**              | Per-video diagnosis (outlier score vs your usual, hook retention at 30 s, retention curve, traffic sources, search terms, SEO score), channel outliers, topic research with breakout videos, best publish time, content ideas from your own data.                                |\n| **Shorts & thumbnails** | Find the best Short-sized moments in a long video and cut vertical 1080x1920 clips; grab frames; generate thumbnails with an image model; have a vision model rank them.                                                                                                         |\n| **AI providers**        | Optional: Claude, OpenAI, Azure OpenAI, Gemini, OpenRouter, Groq, Ollama or any OpenAI-compatible API, with a model per job (writing, vision, images, transcription). Without one, tools hand your AI app the data and a brief.                                                  |\n| **Metadata**            | `generate_metadata` hands your AI the transcript with timestamps plus YouTube's rules; it writes the copy. `preview_metadata` checks limits and chapter rules before anything is sent. Templates add your standard footer, links, tags and naming.                               |\n| **Channel**             | Profile and stats, description, keywords, country, language, trailer for non-subscribers, translations, banner, video watermark.                                                                                                                                                 |\n| **Comments**            | Read comments per video or across the channel, including _held for review_ and _likely spam_; reply as the channel; publish, hold or remove; ban authors; delete your own comments.                                                                                              |\n| **Analytics**           | Overview, daily trend, top videos, traffic sources, YouTube search terms, geography, devices, age and gender, audience retention for a video, subscribed vs not, or any custom metrics and dimensions.                                                                           |\n| **Playlists**           | List, create, edit, delete, add, remove, reorder. Name a playlist and it is found (or created).                                                                                                                                                                                  |\n| **Captions**            | Upload `.srt` / `.vtt`, replace, download, delete; transcription of local videos with OpenAI, Azure OpenAI, Groq, Gemini or any OpenAI-compatible Whisper.                                                                                                                       |\n| **Several channels**    | Connect any number of channels, including brand accounts; pick a default or name one per call.                                                                                                                                                                                   |\n| **Quota-aware**         | Tracks the daily budget, stops on `quotaExceeded` instead of hammering the API, and resumes stopped uploads after the midnight Pacific reset.                                                                                                                                    |\n\n## Install\n\nRequirements: **Node.js 22.13+**. Optional: **ffmpeg**, only for transcription.\n\n```bash\nnpx @joinhackyard/youtube-channel-mcp setup\n```\n\nSetup does four things:\n\n1. **Google credentials** (one time). YouTube only allows this through an OAuth client you own, so setup opens the right Google Cloud pages and you click through:\n   1. [Create a project](https://console.cloud.google.com/projectcreate).\n   2. Enable the [YouTube Data API v3](https://console.cloud.google.com/apis/library/youtube.googleapis.com) and the [YouTube Analytics API](https://console.cloud.google.com/apis/library/youtubeanalytics.googleapis.com).\n   3. [Configure the OAuth consent screen](https://console.cloud.google.com/auth/overview): _External_, then under _Audience_ either add your Google account as a test user, or click **Publish app** so sign-ins don't expire every 7 days (Google shows an “unverified app” notice you can click through for your own app).\n   4. [Create an OAuth client](https://console.cloud.google.com/auth/clients/create) of type **Desktop app** and download the JSON.\n\n   Then drag that JSON file into the terminal. The client ID and secret go into your keychain.\n\n2. **Connect a channel.** Your browser opens Google sign-in; choose the account and the channel.\n3. **AI providers** (optional): add Claude, OpenAI, Azure OpenAI, Gemini, OpenRouter, Groq, Ollama or a custom endpoint, then pick a model per job from each provider's live model list.\n4. **Add to your AI apps.** It detects and configures **Claude Desktop, Claude Code, Cursor, Windsurf, Codex and Hermes Agent**. Your original config is kept as `*.before-youtube-channel-mcp.bak`, and an existing server named `youtube` is never touched. Restart the app afterwards.\n\n5. **Background service** (recommended): keeps uploads going and A/B tests rotating when no AI app is open (launchd on macOS, systemd on Linux, Task Scheduler on Windows).\n\nPrefer a global install? `npm i -g @joinhackyard/youtube-channel-mcp && youtube-channel-mcp setup`.\n\n### Manual configuration\n\n`npx @joinhackyard/youtube-channel-mcp config` prints snippets for your machine. The general shape:\n\n```json\n{\n  \"mcpServers\": {\n    \"youtube-channel\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@joinhackyard/youtube-channel-mcp@latest\"]\n    }\n  }\n}\n```\n\nHermes Agent (`~/.hermes/config.yaml`), where tools appear as `mcp_youtube_channel_*`:\n\n```yaml\nmcp_servers:\n  youtube-channel:\n    command: \"npx\"\n    args: [\"-y\", \"@joinhackyard/youtube-channel-mcp@latest\"]\n    timeout: 180\n```\n\nClaude Code: `claude mcp add youtube-channel --scope user -- npx -y @joinhackyard/youtube-channel-mcp@latest`\n\n## Try it\n\n- “Check my YouTube connection.”\n- “Upload ~/Videos/launch.mp4 as private with the title ‘We shipped v2’, then show me the upload status.”\n- “Transcribe ~/Videos/episode-12.mp4, write three title options, a description with chapters and tags using my podcast template, and schedule it for Friday 18:00 IST with ~/Videos/ep12.jpg as the thumbnail.”\n- “How did the channel do in the last 28 days compared with the month before? Which five videos drove it?”\n- “What are people searching on YouTube to find us?”\n- “List comments held for review, publish the genuine ones and remove the spam.”\n- “Reply to the unanswered questions on my latest video.”\n- “Rewrite the channel description and keywords around hackathons and founders.”\n- “Add Hindi titles and descriptions to my five most viewed videos.”\n- “Make every video in the ‘Drafts’ playlist unlisted.”\n- “Why did my last video under-perform? Suggest three titles and A/B test them for two weeks.”\n- “Upload ~/Videos/demo.mp4 publicly with ab_test thumbnails ~/thumbs/b.jpg and ~/thumbs/c.jpg.”\n- “Find my outliers and research what is breaking out on ‘hackathon India’ this quarter, then give me 10 video ideas.”\n- “Find 5 Shorts in ~/Videos/talk.mp4 and cut the best two.”\n- “Design three thumbnails for ‘We built a robot in 24 hours’ and tell me which one wins.”\n\n## Tools\n\n| Tool                                                                                                                                                                   | What it does                                                          |\n| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- |\n| `auth_status` · `connect_channel` · `list_channels` · `set_default_channel` · `disconnect_channel`                                                                     | Connection, sign-in health, quota, known limits                       |\n| `upload_video` · `get_upload_status` · `list_uploads` · `cancel_upload` · `resume_upload`                                                                              | Background uploads from a file or URL, with progress and resume       |\n| `list_my_videos` · `get_video` · `update_video` · `set_visibility` · `set_thumbnail` · `set_video_localizations` · `delete_video` · `list_categories`                  | Videos                                                                |\n| `get_channel` · `update_channel` · `set_channel_banner` · `set_watermark`                                                                                              | Channel profile and branding                                          |\n| `list_comments` · `reply_to_comment` · `moderate_comments` · `delete_comment`                                                                                          | Comments and moderation                                               |\n| `get_analytics`                                                                                                                                                        | YouTube Analytics reports for the channel or a video                  |\n| `list_playlists` · `create_playlist` · `update_playlist` · `delete_playlist` · `add_to_playlist` · `remove_from_playlist` · `move_in_playlist` · `list_playlist_items` | Playlists                                                             |\n| `list_captions` · `upload_captions` · `download_captions` · `delete_captions` · `transcribe_video`                                                                     | Captions and transcripts                                              |\n| `generate_metadata` · `preview_metadata` · `list_templates` · `save_template` · `delete_template`                                                                      | Writing metadata and channel templates                                |\n| `create_ab_test` · `get_ab_test` · `list_ab_tests` · `stop_ab_test`                                                                                                    | A/B tests of titles, thumbnails and descriptions                      |\n| `analyze_video` · `find_outliers` · `research_topic` · `best_publish_time` · `seo_check` · `content_ideas`                                                             | Growth analysis                                                       |\n| `suggest_shorts` · `create_short` · `extract_frames` · `generate_thumbnails` · `critique_thumbnails`                                                                   | Shorts and thumbnails                                                 |\n| `triage_comments` · `translate_video_metadata`                                                                                                                         | Comment triage with draft replies; translated titles and descriptions |\n| `ai_status` · `set_ai_models`                                                                                                                                          | AI providers and model per job                                        |\n| `quota_status`                                                                                                                                                         | Today's quota estimate                                                |\n\nThere is also a `publish_video` prompt for clients that support MCP prompts.\n\n## A/B testing\n\nYouTube Studio's own _Test & Compare_ (which measures impressions click-through rate) has no API, and the YouTube Analytics API no longer returns impressions or CTR. So this server runs its own tests on the official APIs:\n\n1. **Variants.** A is the live version; B, C, D change the title, thumbnail and/or description.\n2. **Rotation.** One version is live per day, in balanced random order (each block of days shows every version once, so weekdays even out). Days are Pacific Time to match YouTube Analytics. A day only counts if its version went live within 3 hours of midnight; missed or late days are excluded.\n3. **Measurement.** Daily views, watch time, average view percentage, average view duration, subscribers gained or engagement for the video. Counts are compared on a log scale after removing the video's own trend (daily views usually decline), using Welch's t-test against the original.\n4. **Finish.** A goes back live, the server waits about 3 days for analytics to settle, then reports lift and p-values. With `auto_apply_winner`, a significant winner is put live.\n\nRun tests for 14 days or more on videos with steady daily views. For small channels, bold changes (a new thumbnail concept, not a word swap) are the ones that show up. Keep the background service installed so no day is missed.\n\n## AI providers\n\nConnect any mix in a terminal with `npx @joinhackyard/youtube-channel-mcp ai`. Keys go to your OS keychain and are never sent through chat.\n\n| Provider                  | Writing & analysis            | Vision | Thumbnails        | Transcription             |\n| ------------------------- | ----------------------------- | ------ | ----------------- | ------------------------- |\n| Anthropic Claude          | ✓ (default `claude-opus-5-5`) | ✓      |                   |                           |\n| OpenAI                    | ✓                             | ✓      | ✓ (`gpt-image-2`) | ✓ (`whisper-1`)           |\n| Azure OpenAI / AI Foundry | ✓                             | ✓      | ✓                 | ✓ (your deployment names) |\n| Google Gemini             | ✓                             | ✓      | ✓                 | ✓                         |\n| OpenRouter                | ✓                             | ✓      |                   |                           |\n| Groq                      | ✓                             |        |                   | ✓ (`whisper-large-v3`)    |\n| Ollama (local)            | ✓                             | ✓      |                   |                           |\n| Other OpenAI-compatible   | ✓                             | ✓      | ✓                 | ✓                         |\n\nChoose a model per job interactively, with `ai models --text anthropic:claude-opus-5-5 --image openai:gpt-image-2`, or from your AI app with `set_ai_models`. Scripted setup reads keys from stdin, for example `… | npx @joinhackyard/youtube-channel-mcp ai add azure --endpoint https://<resource>.cognitiveservices.azure.com --key-stdin`.\n\n## Approvals\n\nReading is free. Private uploads and private edits go straight through. Anything other people will see or that cannot be undone needs your approval: public, unlisted or scheduled uploads and visibility changes, public replies and comments, channel profile, banner and watermark changes, starting or stopping A/B tests, removing comments or banning authors, and deleting videos, playlists, captions or channels.\n\n- In clients that support MCP elicitation, you get a confirm dialog.\n- Otherwise the tool returns `CONFIRMATION REQUIRED` with a summary and a single-use token tied to those exact arguments. The AI is instructed to show you the summary and call again with the token only after you agree; if the arguments change, the token is rejected. This fallback relies on the AI following instructions, so prefer clients with elicitation, or `YT_CONFIRM=always`, when the AI reads untrusted text such as comments.\n\nSet `YT_CONFIRM=always` to confirm every write, or `never` for unattended pipelines.\n\n## Templates\n\nTemplates are JSON files in `~/.youtube-channel-mcp/templates/` (or ask your AI to call `save_template`):\n\n```json\n{\n  \"name\": \"podcast\",\n  \"description\": \"Weekly episode\",\n  \"title_format\": \"{title} | My Podcast\",\n  \"description_footer\": \"Listen everywhere: https://example.com/podcast\",\n  \"hashtags\": [\"#Podcast\"],\n  \"tags\": [\"podcast\", \"interview\"],\n  \"category_id\": \"22\",\n  \"playlists\": [\"Podcast episodes\"],\n  \"guidance\": \"Lead with the guest's name and the one idea listeners take away.\"\n}\n```\n\n`extends` inherits another template. Tags and hashtags are combined, the footer is appended, and `guidance` is passed to your AI when it writes metadata. A built-in `shorts` template adds `#Shorts`. See [`examples/templates`](examples/templates).\n\n## Things YouTube decides (worth knowing)\n\n- **Unaudited projects upload as private.** Google Cloud projects created after July 2020 that haven't passed the [YouTube API compliance audit](https://support.google.com/youtube/contact/yt_api_form) can have every API upload locked to private. The server detects this and tells you; publish those videos in YouTube Studio, or apply for the audit.\n- **Testing-mode sign-ins last 7 days.** If your consent screen is in _Testing_, Google expires the sign-in weekly. Reconnect (`connect_channel`), or publish the consent screen. Stopped uploads resume on their own after you reconnect.\n- **Quota.** Each Google Cloud project has a daily budget shared by every channel connected through it (by default about 10,000 API units; uploads have their own allowance). `quota_status` shows this server's estimate; the Cloud Console has the exact numbers.\n- **Not available through the API:** pinning comments, changing the channel name or handle, community posts, and Shorts-specific editing. Do those in YouTube Studio.\n- **Phone verification.** Custom thumbnails and videos over 15 minutes need a [verified channel](https://www.youtube.com/verify).\n\n## Configuration\n\nEverything works without these. Environment variables override what setup stored.\n\n| Variable                                                                                      | Default                  |                                                                    |\n| --------------------------------------------------------------------------------------------- | ------------------------ | ------------------------------------------------------------------ |\n| `GOOGLE_CLIENT_ID` / `GOOGLE_CLIENT_SECRET`                                                   | from keychain            | Desktop-app OAuth client                                           |\n| `YT_MCP_HOME`                                                                                 | `~/.youtube-channel-mcp` | Data folder (state database, templates, transcripts)               |\n| `YT_CONFIRM`                                                                                  | `public`                 | `public`, `always` or `never`                                      |\n| `YT_CHUNK_MB`                                                                                 | `16`                     | Upload chunk size (rounded to 256 KB)                              |\n| `YT_DAILY_UNIT_LIMIT` / `YT_DAILY_UPLOAD_LIMIT`                                               | `10000` / `100`          | Budgets used for the local estimate                                |\n| `YT_MCP_VAULT`                                                                                | auto                     | Set to `file` to use the encrypted file instead of the OS keychain |\n| `ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, `GEMINI_API_KEY`, `OPENROUTER_API_KEY`, `GROQ_API_KEY` | from keychain            | AI provider keys (setting them in the environment overrides `ai`)  |\n| `AZURE_OPENAI_ENDPOINT` / `AZURE_OPENAI_API_KEY` / `AZURE_OPENAI_API_VERSION`                 | from `ai`                | Azure OpenAI resource                                              |\n| `OLLAMA_BASE_URL`, `AI_CUSTOM_BASE_URL` / `AI_CUSTOM_API_KEY`                                 |                          | Local or other OpenAI-compatible endpoints                         |\n| `YT_AI_TEXT_MODEL`, `YT_AI_VISION_MODEL`, `YT_AI_IMAGE_MODEL`, `YT_AI_TRANSCRIBE_MODEL`       | from `ai`                | `provider:model` per job                                           |\n| `YT_AI_EFFORT`                                                                                | `medium`                 | Reasoning effort for Claude                                        |\n\n## Security\n\n- Google refresh tokens and client secrets are stored in the OS keychain (macOS Keychain, Windows Credential Manager, Linux Secret Service). On machines without one, they go into an AES-256-GCM encrypted file with a separate `0600` key file.\n- Sign-in uses a one-shot `127.0.0.1` loopback server with PKCE and a random state, as Google recommends for desktop apps.\n- Requested scopes: `youtube.upload`, `youtube`, `youtube.force-ssl` (comments, captions and deletes) and `yt-analytics.readonly` (reports). No monetary or revenue access.\n- AI provider keys live in the OS keychain; the database only stores which provider and model to use.\n- URL downloads refuse private and internal addresses.\n- `disconnect_channel` revokes the token at Google.\n- An audit log of uploads and changes is kept in the local database.\n\n## CLI\n\n```\nyoutube-channel-mcp setup              guided setup (safe to re-run)\nyoutube-channel-mcp connect            connect or reconnect a channel\nyoutube-channel-mcp status             channels, quota, recent uploads\nyoutube-channel-mcp doctor             check everything, explain fixes\nyoutube-channel-mcp install [ids|all]  claude-desktop, claude-code, cursor, windsurf, codex, hermes\nyoutube-channel-mcp uninstall [ids]\nyoutube-channel-mcp config             print config snippets\nyoutube-channel-mcp ai                 connect AI providers and choose models (ai --help for scripted use)\nyoutube-channel-mcp service install    keep uploads and A/B tests running in the background\nyoutube-channel-mcp daemon             run background work in the foreground\n```\n\n## Contributing\n\nContributions are welcome. Start with [CONTRIBUTING.md](CONTRIBUTING.md) for setup, layout and guidelines. Please follow the [Code of Conduct](CODE_OF_CONDUCT.md).\n\n- Questions and setup help: [Discussions](https://github.com/joinhackyard/youtube-channel-mcp/discussions), see also [SUPPORT.md](SUPPORT.md)\n- Bugs and ideas: [Issues](https://github.com/joinhackyard/youtube-channel-mcp/issues/new/choose)\n- Security problems: report privately, see [SECURITY.md](SECURITY.md)\n- Release notes: [CHANGELOG.md](CHANGELOG.md)\n\n## License\n\n[MIT](LICENSE). Built and maintained by [Hackyard](https://hackyard.org). Not affiliated with, or endorsed by, YouTube or Google. YouTube is a trademark of Google LLC.\n","readmeFilename":"README.md"}