{"id":50398622,"url":"https://github.com/fabioc-aloha/youtube-mcp-vscode","last_synced_at":"2026-05-30T22:01:50.008Z","repository":{"id":334974188,"uuid":"1143609715","full_name":"fabioc-aloha/youtube-mcp-vscode","owner":"fabioc-aloha","description":"Self-sufficient VS Code extension for YouTube video intelligence - search, analyze, transcripts, flashcards. Zero external dependencies.","archived":false,"fork":false,"pushed_at":"2026-04-29T00:18:59.000Z","size":5047,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-29T02:27:52.578Z","etag":null,"topics":["education","flashcards","learning","transcript","typescript","video-analysis","vscode-extension","youtube","youtube-api"],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fabioc-aloha.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":"SUPPORT.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-27T19:42:48.000Z","updated_at":"2026-04-29T00:19:03.000Z","dependencies_parsed_at":"2026-01-28T07:14:09.427Z","dependency_job_id":null,"html_url":"https://github.com/fabioc-aloha/youtube-mcp-vscode","commit_stats":null,"previous_names":["fabioc-aloha/youtube-mcp-vscode"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/fabioc-aloha/youtube-mcp-vscode","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabioc-aloha%2Fyoutube-mcp-vscode","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabioc-aloha%2Fyoutube-mcp-vscode/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabioc-aloha%2Fyoutube-mcp-vscode/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabioc-aloha%2Fyoutube-mcp-vscode/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fabioc-aloha","download_url":"https://codeload.github.com/fabioc-aloha/youtube-mcp-vscode/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabioc-aloha%2Fyoutube-mcp-vscode/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33711018,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-30T02:00:06.278Z","response_time":92,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["education","flashcards","learning","transcript","typescript","video-analysis","vscode-extension","youtube","youtube-api"],"created_at":"2026-05-30T22:01:49.285Z","updated_at":"2026-05-30T22:01:49.998Z","avatar_url":"https://github.com/fabioc-aloha.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# YouTube MCP Tools for VS Code\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"media/banner.png\" alt=\"YouTube MCP Tools Banner\" width=\"100%\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://marketplace.visualstudio.com/items?itemName=fabioc-aloha.youtube-mcp-tools\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Version-0.2.1-blue?style=for-the-badge\u0026logo=visual-studio-code\" alt=\"Version\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://marketplace.visualstudio.com/items?itemName=fabioc-aloha.youtube-mcp-tools\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Marketplace-VS%20Code-007ACC?style=for-the-badge\u0026logo=visual-studio-code\" alt=\"VS Code Marketplace\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/fabioc-aloha/youtube-mcp-vscode/blob/main/LICENSE\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/License-MIT-green?style=for-the-badge\" alt=\"License: MIT\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003e🎬 Bring YouTube video intelligence directly into VS Code\u003c/strong\u003e\u003cbr\u003e\n  Search • Analyze • Transcribe • Generate Flashcards\n\u003c/p\u003e\n\n---\n\n## ✨ What it does\n\n| Tool | API key needed? | Use case |\n|---|---|---|\n| 📝 **Get transcript** | ❌ No | \"Give me the transcript of this video\" — returns Markdown with clickable timestamps so an AI can cite specific moments and you can jump there |\n| 🔎 **Search inside transcript** | ❌ No | \"Where in this 2-hour podcast did they mention X?\" — returns matching moments + deep-link URLs, far cheaper than dumping the whole transcript into the AI |\n| 📈 **Quota status** | ❌ No | See how much YouTube Data API quota this server has used |\n| 🔍 **Search YouTube** | ✅ Yes | Search for videos by query (100 quota units = ~100 searches/day on free tier) |\n| 📊 **Get video details** | ✅ Yes | Title, channel, duration, view/like counts, tags, caption availability |\n| 🧠 **Analyze video** | ✅ Yes | Summary, key points, topics, extracted concepts, observable quality signals |\n| 🎴 **Generate flashcards** | ✅ Yes | Front/back study cards from key concepts |\n\n\u003e **The transcript tools work without a Google API key.** That covers the\n\u003e single most common use case (\"summarize this video for me\") with zero\n\u003e setup. Add an API key later if you want search and analysis too.\n\n## ⚡ Quick start (MCP server, no API key)\n\nThe fastest way to try it from any MCP client (Claude Desktop, VS Code Agent\nMode, Cursor, custom agents):\n\n**1. Add to your MCP client config**\n\n`.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"youtube\": {\n      \"command\": \"node\",\n      \"args\": [\"${workspaceFolder}/node_modules/youtube-mcp-tools/dist/mcp-server.js\"]\n    }\n  }\n}\n```\n\nClaude Desktop (`claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"youtube\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/dist/mcp-server.js\"]\n    }\n  }\n}\n```\n\n**2. Ask your AI**\n\n\u003e \"Get the transcript of `https://youtu.be/jNQXAC9IVRw` and tell me what it's about.\"\n\n\u003e \"In `https://youtu.be/dQw4w9WgXcQ`, where do they say 'never gonna'?\"\n\nThe AI calls `youtube_get_transcript` or `youtube_search_transcript`, gets\nback Markdown with `[03:42](https://youtu.be/X?t=222)` clickable timestamps,\nand cites them in its answer.\n\n**3. (Optional) Add an API key for richer tools**\n\nSet `YOUTUBE_API_KEY` in your MCP client's `env` block to unlock search,\nvideo details, full analysis, and flashcards.\n\n## 📦 Installation (VS Code extension)\n\n1. Open VS Code\n2. Press `Ctrl+P` / `Cmd+P`\n3. Type `ext install fabioc-aloha.youtube-mcp-tools`\n4. Press Enter\n\n**Or** search for \"YouTube MCP Tools\" in the Extensions view.\n\n## ⚙️ Setup\n\n### Get a YouTube API Key\n\n1. Go to [Google Cloud Console](https://console.cloud.google.com/apis/credentials)\n2. Create a new project (or select existing)\n3. Enable the **YouTube Data API v3**\n4. Create an API Key\n5. Copy the key\n\n### Configure the Extension\n\n**Option 1: VS Code Settings** (Recommended)\n\n```\nCtrl+, → Search \"youtubeMcp.apiKey\" → Paste your key\n```\n\n**Option 2: .env File**\nCreate a `.env` file in your workspace root:\n\n```env\nYOUTUBE_API_KEY=your-api-key-here\n```\n\n**Option 3: Secure Command** (Recommended)\n\nRun `YouTube MCP: Set API Key` command. Your key is:\n- Validated before storage\n- Encrypted using VS Code SecretStorage\n- Never exposed in settings or files\n\n## 🎯 Commands\n\n| Command | Shortcut | Description |\n|---------|----------|-------------|\n| `YouTube MCP: Search YouTube` | `Ctrl+Shift+Y S` | Search for videos by keyword |\n| `YouTube MCP: Analyze Video` | `Ctrl+Shift+Y A` | Get comprehensive video analysis |\n| `YouTube MCP: Get Transcript` | `Ctrl+Shift+Y T` | Extract timestamped transcript |\n| `YouTube MCP: Generate Flashcards` | `Ctrl+Shift+Y F` | Create flashcards from video |\n| `YouTube MCP: Set API Key` | - | Securely set your API key |\n| `YouTube MCP: Show Quota Status` | - | Check API quota usage |\n| `YouTube MCP: Open Settings` | - | Configure extension settings |\n\nAccess all commands via `Ctrl+Shift+P` / `Cmd+Shift+P`.\n\n## 🔒 Security Features\n\n- **Encrypted Storage** - API keys stored in VS Code's SecretStorage\n- **Key Validation** - API keys validated before storage\n- **Rate Limiting** - Automatic request throttling (10 req/sec)\n- **Exponential Backoff** - Smart retries for transient failures\n- **Quota Persistence** - Usage tracking persists across sessions\n\n## 📊 Video Analysis Output\n\nWhen you analyze a video, you get:\n\n```markdown\n# Video Title\n\n**Channel:** Channel Name\n**Duration:** 15m 30s\n**Views:** 1,234,567 | **Likes:** 45,678\n\n---\n\n## Summary\nBrief overview of the video content...\n\n### Detailed\nIn-depth analysis of the video...\n\n## Key Points\n- Important point 1\n- Important point 2\n- Important point 3\n\n## Key Concepts\n### Machine Learning\nDefinition and context...\n*Type: term | Mentions: 15*\n\n## Quality Signals\n| Signal | Value |\n|--------|-------|\n| Has captions | yes |\n| Word count | 4,318 |\n| Avg sentence length | 18 words |\n| Engagement (likes/views) | 3.70% |\n| Transcript segments | 412 |\n```\n\n\u003e Quality is reported as **measurable signals**, not opaque 0–100 scores.\n\u003e Interpret them per your use case — long-form lectures want different\n\u003e signals than short tutorials.\n\n## 🤖 Use From Any MCP Client\n\nBeyond the VS Code UI, this package ships a standalone **Model Context\nProtocol** server (`youtube-mcp-server`). Any MCP-aware client can call its\ntools — `youtube_search`, `youtube_get_video_details`,\n`youtube_get_transcript`, `youtube_analyze_video`,\n`youtube_generate_flashcards`, `youtube_quota_status`.\n\n### VS Code Agent Mode (`.vscode/mcp.json`)\n\n```json\n{\n  \"servers\": {\n    \"youtube\": {\n      \"command\": \"node\",\n      \"args\": [\"${workspaceFolder}/node_modules/youtube-mcp-tools/dist/mcp-server.js\"],\n      \"env\": { \"YOUTUBE_API_KEY\": \"${env:YOUTUBE_API_KEY}\" }\n    }\n  }\n}\n```\n\n### Claude Desktop (`claude_desktop_config.json`)\n\n```json\n{\n  \"mcpServers\": {\n    \"youtube\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/dist/mcp-server.js\"],\n      \"env\": { \"YOUTUBE_API_KEY\": \"AIza...\" }\n    }\n  }\n}\n```\n\n### Standalone\n\n```bash\nYOUTUBE_API_KEY=AIza... node dist/mcp-server.js\n```\n\nThe server speaks JSON-RPC over stdio. Logs go to stderr only — stdout is\nreserved for the protocol channel.\n\n## 🎴 Flashcard Generation\n\nFlashcards are generated from:\n\n- **Key Points** extracted from the video\n- **Concepts** identified in the content\n- **Topics** covered in the video\n\nPerfect for:\n\n- 📚 Learning new technologies\n- 🎓 Studying for certifications\n- 💡 Retaining video course content\n\n## ⚙️ Settings\n\n| Setting | Default | Description |\n|---------|---------|-------------|\n| `youtubeMcp.apiKey` | - | Your YouTube Data API key |\n| `youtubeMcp.maxResults` | 10 | Search results (1-50) |\n| `youtubeMcp.preferredDuration` | any | Filter: any, short, medium, long |\n| `youtubeMcp.defaultRegion` | US | Region code for searches |\n| `youtubeMcp.autoAnalyze` | false | Auto-analyze on video select |\n\n## 📁 Activity Bar Views\n\nLook for the **YouTube** icon in the Activity Bar:\n\n- **🔍 Search Results** - Videos from your last search\n- **📜 Recent Videos** - Your video history\n- **🎴 Flashcards** - Generated study cards\n\n## 🔒 Privacy \u0026 Security\n\n- ✅ API keys stored locally in VS Code settings or `.env`\n- ✅ No data sent to third-party servers\n- ✅ No telemetry or tracking\n- ✅ All processing happens locally\n\n## 📝 Requirements\n\n- VS Code 1.109.0 or higher\n- YouTube Data API key ([Get one free](https://console.cloud.google.com/apis/credentials))\n\n## 🤝 Contributing\n\nContributions welcome! Please see our [GitHub repository](https://github.com/fabioc-aloha/youtube-mcp-vscode).\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://correax.com\"\u003e\n    \u003cimg src=\"media/correax-logo.png\" alt=\"CorreaX\" height=\"32\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eMade with ❤️ by \u003ca href=\"https://correax.com\"\u003eCorreaX\u003c/a\u003e\u003c/strong\u003e\u003cbr\u003e\n  \u003csub\u003eBuilding intelligent tools for developers\u003c/sub\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/fabioc-aloha/youtube-mcp-vscode/issues\"\u003eReport Bug\u003c/a\u003e •\n  \u003ca href=\"https://github.com/fabioc-aloha/youtube-mcp-vscode/issues\"\u003eRequest Feature\u003c/a\u003e •\n  \u003ca href=\"https://github.com/fabioc-aloha/youtube-mcp-vscode/stargazers\"\u003e⭐ Star on GitHub\u003c/a\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffabioc-aloha%2Fyoutube-mcp-vscode","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffabioc-aloha%2Fyoutube-mcp-vscode","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffabioc-aloha%2Fyoutube-mcp-vscode/lists"}