{"_id":"@umbertotancorre/youtube-mcp","_rev":"6-623775e834cc7fcce21e9f5d37886c17","name":"@umbertotancorre/youtube-mcp","dist-tags":{"latest":"1.1.1"},"versions":{"1.0.0":{"name":"@umbertotancorre/youtube-mcp","version":"1.0.0","keywords":["mcp","modelcontextprotocol","youtube","transcript","download","ai"],"license":"MIT","_id":"@umbertotancorre/youtube-mcp@1.0.0","maintainers":[{"name":"umbertotancorre","email":"u.tancorre@gmail.com"}],"homepage":"https://github.com/umbertotancorre/youtube-mcp#readme","bugs":{"url":"https://github.com/umbertotancorre/youtube-mcp/issues"},"bin":{"youtube-mcp":"dist/index.js"},"dist":{"shasum":"519626d86d37ca2466f526b46123a1b91c0916b9","tarball":"https://registry.npmjs.org/@umbertotancorre/youtube-mcp/-/youtube-mcp-1.0.0.tgz","fileCount":4,"integrity":"sha512-wCkaDkvMIcM+vRWHv/JFAx3IQ2bsKmA2bUmZw52mOIjHRlKxaR4Ge5fPXmW0levKjA21Zw/7kInclfVLM0B/gg==","signatures":[{"sig":"MEUCIF+HV3CwhL4qpOiE7vftY0TKNKqdVuk+4IivxTfGgZrdAiEA2jSD0315zXAxSxIn3xf0+FpQ8XYcGZmrrwzrzMOJMO4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":40882},"main":"dist/index.js","gitHead":"94769b2b45b16b01f420eef2f4558bd2c68d6e7f","scripts":{"dev":"ts-node src/index.ts","build":"tsc","start":"node dist/index.js","postinstall":"node -e \"const{helpers}=require('ytdlp-nodejs');const d=helpers.BIN_DIR;Promise.all([helpers.downloadYtDlp(d),helpers.downloadFFmpeg(d)]).catch(e=>{console.error(e.message);process.exit(1)})\""},"_npmUser":{"name":"umbertotancorre","email":"u.tancorre@gmail.com"},"repository":{"url":"git+https://github.com/umbertotancorre/youtube-mcp.git","type":"git"},"_npmVersion":"11.6.2","description":"MCP server for YouTube transcripts, metadata, search, and downloads","directories":{},"_nodeVersion":"23.6.1","dependencies":{"ytdlp-nodejs":"^3.4.4","youtube-transcript":"^1.2.1","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"ts-node":"^10.9.2","typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/youtube-mcp_1.0.0_1779101197355_0.5951840588652306","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@umbertotancorre/youtube-mcp","version":"1.0.1","keywords":["mcp","modelcontextprotocol","youtube","transcript","download","ai"],"license":"MIT","_id":"@umbertotancorre/youtube-mcp@1.0.1","maintainers":[{"name":"umbertotancorre","email":"u.tancorre@gmail.com"}],"homepage":"https://github.com/umbertotancorre/youtube-mcp#readme","bugs":{"url":"https://github.com/umbertotancorre/youtube-mcp/issues"},"bin":{"youtube-mcp":"dist/index.js"},"dist":{"shasum":"43284760b2c05600bc87855dd3a99631125699ef","tarball":"https://registry.npmjs.org/@umbertotancorre/youtube-mcp/-/youtube-mcp-1.0.1.tgz","fileCount":4,"integrity":"sha512-SNXKcjCfTjL7Pcx+c5BWu41/tlfK6X+cImsFafwqm2ONLShR4ApnSFcVH8uOg5dS8uxqU6kMsDR0jHZP2AHS2A==","signatures":[{"sig":"MEQCIHbgQTCfNM4s+P1e0P80yS9P6aUS26e/kvZOEHpR0DDmAiBdu/K2O5ldpxxS2w1/PygWla8/unbK62rAFZsV2K1ZiQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":41660},"main":"dist/index.js","engines":{"node":">=18"},"gitHead":"b234fdf40ac4000384a430dc1f759c451a79e68c","scripts":{"dev":"ts-node src/index.ts","build":"tsc","start":"node dist/index.js","postinstall":"node -e \"const{helpers}=require('ytdlp-nodejs');const d=helpers.BIN_DIR;Promise.all([helpers.downloadYtDlp(d),helpers.downloadFFmpeg(d)]).catch(e=>{console.error(e.message);process.exit(1)})\""},"_npmUser":{"name":"umbertotancorre","email":"u.tancorre@gmail.com"},"repository":{"url":"git+https://github.com/umbertotancorre/youtube-mcp.git","type":"git"},"_npmVersion":"11.6.2","description":"MCP server for YouTube transcripts, metadata, search, and downloads","directories":{},"_nodeVersion":"23.6.1","dependencies":{"ytdlp-nodejs":"^3.4.4","youtube-transcript":"^1.2.1","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"ts-node":"^10.9.2","typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/youtube-mcp_1.0.1_1779106163273_0.9787780855880592","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@umbertotancorre/youtube-mcp","version":"1.0.2","keywords":["mcp","modelcontextprotocol","youtube","transcript","download","ai"],"license":"MIT","_id":"@umbertotancorre/youtube-mcp@1.0.2","maintainers":[{"name":"umbertotancorre","email":"u.tancorre@gmail.com"}],"homepage":"https://github.com/umbertotancorre/youtube-mcp#readme","bugs":{"url":"https://github.com/umbertotancorre/youtube-mcp/issues"},"bin":{"youtube-mcp":"dist/index.js"},"dist":{"shasum":"2229e453fefbf3eb54f486642be7b82ce2516112","tarball":"https://registry.npmjs.org/@umbertotancorre/youtube-mcp/-/youtube-mcp-1.0.2.tgz","fileCount":4,"integrity":"sha512-PCx9b+rcAWDGqtZEkSnP/jvwvtD9AiHeuTUWpjBxxw6v/aIHaCwXJDfig5J/clwEkOhbBuxuhfghw/FGXqR+3g==","signatures":[{"sig":"MEUCIFZP4ICB793B4RcQT9EqvK3wirlgl0FdAHw0s8W3I2OlAiEAsk+vVu2n91CXdEMMk6n3F7APrR0dpKHrN0DS82wDvO8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":41652},"main":"dist/index.js","engines":{"node":">=18"},"gitHead":"44b0b8e8ae0b26229b495a20eea839bd9a6c2ae5","scripts":{"dev":"ts-node src/index.ts","build":"tsc","start":"node dist/index.js","postinstall":"node -e \"const{helpers}=require('ytdlp-nodejs');const d=helpers.BIN_DIR;Promise.all([helpers.downloadYtDlp(d),helpers.downloadFFmpeg(d)]).catch(e=>{console.error(e.message);process.exit(1)})\""},"_npmUser":{"name":"umbertotancorre","email":"u.tancorre@gmail.com"},"deprecated":"Upgraded to 1.1.0. Also available as a CLI: npm install -g @umbertotancorre/youtube-cli","repository":{"url":"git+https://github.com/umbertotancorre/youtube-mcp.git","type":"git"},"_npmVersion":"11.6.2","description":"MCP server for YouTube transcripts, metadata, search, and downloads","directories":{},"_nodeVersion":"23.6.1","dependencies":{"ytdlp-nodejs":"^3.4.4","youtube-transcript":"^1.2.1","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"ts-node":"^10.9.2","typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/youtube-mcp_1.0.2_1779202335944_0.3487909881818938","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@umbertotancorre/youtube-mcp","version":"1.1.0","keywords":["mcp","modelcontextprotocol","youtube","transcript","download","ai"],"license":"MIT","_id":"@umbertotancorre/youtube-mcp@1.1.0","maintainers":[{"name":"umbertotancorre","email":"u.tancorre@gmail.com"}],"homepage":"https://github.com/umbertotancorre/youtube-mcp-cli#readme","bugs":{"url":"https://github.com/umbertotancorre/youtube-mcp-cli/issues"},"bin":{"youtube-mcp":"dist/index.js"},"dist":{"shasum":"e8226085376afd8cba2c21f7368b01e5776756d6","tarball":"https://registry.npmjs.org/@umbertotancorre/youtube-mcp/-/youtube-mcp-1.1.0.tgz","fileCount":4,"integrity":"sha512-nWWUEN1YlD7rL2vzkjvrZEnKQxwpDWnjvzSQoovpZVoyFZo/IP/NYuAddZhWyr5eG3W5kkivb2Q7TosAccK+CA==","signatures":[{"sig":"MEYCIQC9Vzn+LMj44fqpsKSqcBIb5Pc7hCi0Q0oe/P7OZ/dE1wIhAIIRgzzvbL4Xjc0rJZushQgbR09RmkVCccgavZ+49LfQ","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":39007},"main":"dist/index.js","engines":{"node":">=18"},"gitHead":"340d08f62188fc1fda237866d00dd3982969ebb6","scripts":{"dev":"ts-node src/index.ts","build":"tsup","start":"node dist/index.js","postinstall":"node -e \"const{helpers}=require('ytdlp-nodejs');const d=helpers.BIN_DIR;Promise.all([helpers.downloadYtDlp(d),helpers.downloadFFmpeg(d)]).catch(e=>{console.error(e.message);process.exit(1)})\""},"_npmUser":{"name":"umbertotancorre","email":"u.tancorre@gmail.com"},"repository":{"url":"git+https://github.com/umbertotancorre/youtube-mcp-cli.git","type":"git","directory":"packages/mcp"},"_npmVersion":"11.6.2","description":"MCP server for YouTube transcripts, metadata, search, and downloads","directories":{},"_nodeVersion":"23.6.1","dependencies":{"ytdlp-nodejs":"^3.4.4","youtube-transcript":"^1.2.1","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","ts-node":"^10.9.2","typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/youtube-mcp_1.1.0_1779394734451_0.8959419575991345","host":"s3://npm-registry-packages-npm-production"}},"1.1.1":{"name":"@umbertotancorre/youtube-mcp","version":"1.1.1","description":"MCP server for YouTube transcripts, metadata, search, and downloads","main":"dist/index.js","bin":{"youtube-mcp":"dist/index.js"},"repository":{"type":"git","url":"git+https://github.com/umbertotancorre/youtube-mcp-cli.git","directory":"packages/mcp"},"keywords":["mcp","modelcontextprotocol","youtube","transcript","download","ai"],"engines":{"node":">=18"},"license":"MIT","scripts":{"build":"tsup","dev":"ts-node src/index.ts","start":"node dist/index.js","postinstall":"node -e \"const{helpers}=require('ytdlp-nodejs');const d=helpers.BIN_DIR;Promise.all([helpers.downloadYtDlp(d),helpers.downloadFFmpeg(d)]).catch(e=>{console.error(e.message);process.exit(1)})\""},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","ytdlp-nodejs":"^3.4.4"},"devDependencies":{"@types/node":"^20.0.0","ts-node":"^10.9.2","tsup":"^8.0.0","typescript":"^5.0.0"},"gitHead":"bdc9c2bb8137e57bf35f60073dbb0e4df87d2cae","_id":"@umbertotancorre/youtube-mcp@1.1.1","bugs":{"url":"https://github.com/umbertotancorre/youtube-mcp-cli/issues"},"homepage":"https://github.com/umbertotancorre/youtube-mcp-cli#readme","_nodeVersion":"23.6.1","_npmVersion":"11.6.2","dist":{"integrity":"sha512-yW+I1mDwDfp+BbukFhOyvFBMsg2nQO2z4TBmB6lZ2rP5YNnTMCgdcqgeLV4b8dfVfqWsUtA7NPl5GMGvmlC2NQ==","shasum":"70f0058d80d6126f624766fb7ad50507ab0e9a29","tarball":"https://registry.npmjs.org/@umbertotancorre/youtube-mcp/-/youtube-mcp-1.1.1.tgz","fileCount":4,"unpackedSize":41676,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIEZAt+nD6/jtDxA1hGGvTbwlViB4jyTy2rgrocuIb3c/AiEAunPYHo21dmYRnb8A/gcdzpZqu6NzIitTEDzr7GYCODU="}]},"_npmUser":{"name":"umbertotancorre","email":"u.tancorre@gmail.com"},"directories":{},"maintainers":[{"name":"umbertotancorre","email":"u.tancorre@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/youtube-mcp_1.1.1_1786383800991_0.5708693849410647"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-18T10:46:37.205Z","modified":"2026-08-10T17:43:21.269Z","1.0.0":"2026-05-18T10:46:37.500Z","1.0.1":"2026-05-18T12:09:23.448Z","1.0.2":"2026-05-19T14:52:16.068Z","1.1.0":"2026-05-21T20:18:54.591Z","1.1.1":"2026-08-10T17:43:21.126Z"},"bugs":{"url":"https://github.com/umbertotancorre/youtube-mcp-cli/issues"},"license":"MIT","homepage":"https://github.com/umbertotancorre/youtube-mcp-cli#readme","keywords":["mcp","modelcontextprotocol","youtube","transcript","download","ai"],"repository":{"type":"git","url":"git+https://github.com/umbertotancorre/youtube-mcp-cli.git","directory":"packages/mcp"},"description":"MCP server for YouTube transcripts, metadata, search, and downloads","maintainers":[{"name":"umbertotancorre","email":"u.tancorre@gmail.com"}],"readme":"# YouTube MCP\n\n[![npm](https://img.shields.io/npm/v/@umbertotancorre/youtube-mcp)](https://www.npmjs.com/package/@umbertotancorre/youtube-mcp)\n[![npm downloads](https://img.shields.io/npm/dt/@umbertotancorre/youtube-mcp?color=blue)](https://www.npmjs.com/package/@umbertotancorre/youtube-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![Node](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org)\n\nAn [MCP](https://modelcontextprotocol.io) server that gives any MCP-compatible AI agents the ability to access YouTube:\n\n- Fetch transcript (plain text or with timestamps)\n- Download transcript as `.md`\n- Get video metadata\n- Search within captions\n- Download video or audio\n\nAll locally. No API keys required.\n\n## Installation\n\n**Method A: let your AI do it**\n\nTell your AI agent:\n\n```\nAdd youtube-mcp as an MCP server. Run it with: npx @umbertotancorre/youtube-mcp\n```\n\n**Method B: manual config**\n\nAdd this to your MCP client config (e.g. `claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"youtube\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@umbertotancorre/youtube-mcp\"]\n    }\n  }\n}\n```\n\nAll tools appear automatically. No install needed, `npx` handles it on first run.\n\n## Tools\n\n| Tool | Description |\n|---|---|\n| `get_transcript` | Fetches the full transcript as plain text |\n| `get_transcript_timed` | Transcript with `[MM:SS]` timestamps per segment |\n| `download_transcript` | Saves transcript as a `.md` file |\n| `download_transcript_timed` | Saves transcript as a `.md` file with timestamps |\n| `get_metadata` | Returns title, channel, publish date, view count, duration, likes, and description |\n| `search_transcript` | Searches for a keyword or phrase and returns matching segments with timestamps |\n| `download_video` | Downloads video+audio as `.mp4` |\n| `download_audio` | Downloads audio as `.mp3` (or `m4a`, `flac`, `opus`, ...) |\n\n`download_video` and `download_audio` are fully self-contained. [`yt-dlp`](https://github.com/yt-dlp/yt-dlp) and [`ffmpeg`](https://github.com/FFmpeg/FFmpeg) are downloaded automatically on install.\n\n## Also available\n\nLooking for a terminal tool instead? See [`@umbertotancorre/youtube-cli`](https://www.npmjs.com/package/@umbertotancorre/youtube-cli).\n\n## Disclaimer\n\nThis project only accesses **publicly available** YouTube data: the same captions, metadata, and streams visible in any browser. It does not bypass authentication, paywalls, or age gates.\n\nEnd users are responsible for complying with YouTube's Terms of Service. This is a local tool you run on your own machine.\n\n## License\n\n`@umbertotancorre/youtube-mcp` is fully open source, licensed under the [MIT License](LICENSE).\n","readmeFilename":"README.md"}