{"_id":"zubeid-youtube-mcp-server","_rev":"3-81e8ca898c38bcd5b0f03b6b1dd9cbe6","name":"zubeid-youtube-mcp-server","dist-tags":{"latest":"1.0.2"},"versions":{"1.0.0":{"name":"zubeid-youtube-mcp-server","version":"1.0.0","keywords":["youtube","mcp","model-context-protocol","ai","claude","anthropic"],"author":{"name":"Zubeid Hendricks"},"license":"MIT","_id":"zubeid-youtube-mcp-server@1.0.0","maintainers":[{"name":"zubeidhendricks","email":"zubeid.hendricks@gmail.com"}],"homepage":"https://github.com/ZubeidHendricks/youtube-mcp-server#readme","bugs":{"url":"https://github.com/ZubeidHendricks/youtube-mcp-server/issues"},"bin":{"zubeid-youtube-mcp-server":"dist/cli.js"},"dist":{"shasum":"3c85ad96b653a790f85858ccd8fc370746c53245","tarball":"https://registry.npmjs.org/zubeid-youtube-mcp-server/-/zubeid-youtube-mcp-server-1.0.0.tgz","fileCount":46,"integrity":"sha512-zawp7ILFI3yDyAlaEupv2TkVdi+X3m6NJ80vFQoecFtrLtt2sYON3YkFQIl70dq7y15C2c65NeZ1of3txnaz1g==","signatures":[{"sig":"MEYCIQCKfjnfPNLFs6IfL4ZedR/UHn6EW54a1s96GShNsNDtlAIhAOJPgoQCPBVsOthnTLeVTJckOcbb/aMfuQUK07rVKw3Q","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":157308},"main":"dist/index.js","types":"./dist/index.d.ts","gitHead":"945d8386a61856a9c2deab94bdbb07e9a70706bc","scripts":{"dev":"nodemon ./src/index.ts","build":"tsc","start":"ts-node ./src/index.ts","prepublishOnly":"npm run build"},"_npmUser":{"name":"zubeidhendricks","email":"zubeid.hendricks@gmail.com"},"repository":{"url":"git+https://github.com/ZubeidHendricks/youtube-mcp-server.git","type":"git"},"_npmVersion":"10.9.0","description":"YouTube MCP Server Implementation","directories":{},"_nodeVersion":"22.11.0","dependencies":{"ytdl-core":"^4.11.5","googleapis":"^129.0.0","youtube-transcript":"^1.0.6","@modelcontextprotocol/sdk":"^1.1.1"},"_hasShrinkwrap":false,"devDependencies":{"nodemon":"^3.0.0","ts-node":"^10.9.1","typescript":"^5.0.0","@types/node":"^18.0.0"},"_npmOperationalInternal":{"tmp":"tmp/zubeid-youtube-mcp-server_1.0.0_1745706918344_0.5633370759058125","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"zubeid-youtube-mcp-server","version":"1.0.1","keywords":["youtube","mcp","model-context-protocol","ai","claude","anthropic"],"author":{"name":"Zubeid Hendricks"},"license":"MIT","_id":"zubeid-youtube-mcp-server@1.0.1","maintainers":[{"name":"zubeidhendricks","email":"zubeid.hendricks@gmail.com"}],"homepage":"https://github.com/ZubeidHendricks/youtube-mcp-server#readme","bugs":{"url":"https://github.com/ZubeidHendricks/youtube-mcp-server/issues"},"bin":{"zubeid-youtube-mcp-server":"dist/cli.js"},"dist":{"shasum":"f5edfa2e3264ffc646a99f6b559122f68ebfac9d","tarball":"https://registry.npmjs.org/zubeid-youtube-mcp-server/-/zubeid-youtube-mcp-server-1.0.1.tgz","fileCount":23,"integrity":"sha512-i3sb5XnvBsEawjBYlNwtG5eIOpV4UGsUtFhbUeUngfcfXpy806kF7tBRWU6PvXG51MzG5ECYW73D7gUiVhLiRg==","signatures":[{"sig":"MEYCIQCNru1JO0PRiN2Ku6F9uU0Snkyt4H3F67EH1eyueufv/QIhAKilNm0pm+3X3yCJAWOU1x4zkAIivS3B+LgwgDqdLSXv","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":79539},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"79e8f8a3b6c0371a091614df4010f8ca8f014ff8","scripts":{"dev":"nodemon --exec \"npm run build && npm start\" --ext ts","build":"tsc","start":"node ./dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"zubeidhendricks","email":"zubeid.hendricks@gmail.com"},"repository":{"url":"git+https://github.com/ZubeidHendricks/youtube-mcp-server.git","type":"git"},"_npmVersion":"11.13.0","description":"YouTube MCP Server Implementation","directories":{},"_nodeVersion":"24.16.0","dependencies":{"dotenv":"^17.3.1","ytdl-core":"^4.11.5","googleapis":"^129.0.0","youtube-transcript":"^1.0.6","@modelcontextprotocol/sdk":"^1.1.1"},"_hasShrinkwrap":false,"devDependencies":{"nodemon":"^3.0.0","ts-node":"^10.9.1","typescript":"^5.0.0","@types/node":"^18.0.0"},"_npmOperationalInternal":{"tmp":"tmp/zubeid-youtube-mcp-server_1.0.1_1784202241675_0.7337481405042654","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"zubeid-youtube-mcp-server","version":"1.0.2","description":"YouTube MCP Server Implementation","type":"module","main":"dist/index.js","bin":{"zubeid-youtube-mcp-server":"dist/cli.js"},"scripts":{"start":"node ./dist/index.js","build":"tsc","dev":"nodemon --exec \"npm run build && npm start\" --ext ts","prepublishOnly":"npm run build","test":"node scripts/smoke-test.mjs"},"dependencies":{"@modelcontextprotocol/sdk":"^1.1.1","dotenv":"^17.3.1","googleapis":"^173.0.0","youtube-transcript":"^1.3.1"},"devDependencies":{"@types/node":"^18.0.0","nodemon":"^3.0.0","ts-node":"^10.9.1","typescript":"^5.0.0"},"keywords":["youtube","mcp","model-context-protocol","ai","claude","anthropic"],"author":{"name":"Zubeid Hendricks"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/ZubeidHendricks/youtube-mcp-server.git"},"bugs":{"url":"https://github.com/ZubeidHendricks/youtube-mcp-server/issues"},"homepage":"https://github.com/ZubeidHendricks/youtube-mcp-server#readme","gitHead":"7a3f6e72b8ff7643456f6b6f2cd5dab293cd3551","types":"./dist/index.d.ts","_id":"zubeid-youtube-mcp-server@1.0.2","_nodeVersion":"22.23.1","_npmVersion":"12.0.1","dist":{"integrity":"sha512-l003/ro9Hkb5a1LJ+Ai8mBk9M9LA/yuhOaoNqf2+9e2NVPtVuZkTxpOX+TCsWvgIo8N4oIM+X+dLATvXDhRieQ==","shasum":"4e4574b8a8d461d6d787717eb28a8011e78cd367","tarball":"https://registry.npmjs.org/zubeid-youtube-mcp-server/-/zubeid-youtube-mcp-server-1.0.2.tgz","fileCount":23,"unpackedSize":79815,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/zubeid-youtube-mcp-server@1.0.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCW4NNbbuGvFwmjkEVHlMYbeZ4s+1uQvUiu29x+PN2FpwIgSRjyq/XwpKGz1KMt9m0UpTl7XHfZv9WVNxLtUsXc5L0="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:16f6f821-1d1e-414e-ba3d-5f548c4e15f3"}},"directories":{},"maintainers":[{"name":"zubeidhendricks","email":"zubeid.hendricks@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/zubeid-youtube-mcp-server_1.0.2_1784211215043_0.6535590100989954"},"_hasShrinkwrap":false}},"time":{"created":"2025-04-26T22:35:18.276Z","modified":"2026-07-16T14:13:35.576Z","1.0.0":"2025-04-26T22:35:18.525Z","1.0.1":"2026-07-16T11:44:01.812Z","1.0.2":"2026-07-16T14:13:35.202Z"},"bugs":{"url":"https://github.com/ZubeidHendricks/youtube-mcp-server/issues"},"author":{"name":"Zubeid Hendricks"},"license":"MIT","homepage":"https://github.com/ZubeidHendricks/youtube-mcp-server#readme","keywords":["youtube","mcp","model-context-protocol","ai","claude","anthropic"],"repository":{"type":"git","url":"git+https://github.com/ZubeidHendricks/youtube-mcp-server.git"},"description":"YouTube MCP Server Implementation","maintainers":[{"name":"zubeidhendricks","email":"zubeid.hendricks@gmail.com"}],"readme":"# YouTube MCP Server\n[![npm version](https://img.shields.io/npm/v/zubeid-youtube-mcp-server)](https://www.npmjs.com/package/zubeid-youtube-mcp-server)\n[![npm downloads](https://img.shields.io/npm/dm/zubeid-youtube-mcp-server?label=downloads%2Fmonth)](https://www.npmjs.com/package/zubeid-youtube-mcp-server)\n[![npm total downloads](https://img.shields.io/npm/dt/zubeid-youtube-mcp-server?label=total%20downloads)](https://www.npmjs.com/package/zubeid-youtube-mcp-server)\n[![smithery badge](https://smithery.ai/badge/@ZubeidHendricks/youtube)](https://smithery.ai/server/@ZubeidHendricks/youtube)\n\nA Model Context Protocol (MCP) server implementation for YouTube, enabling AI language models to interact with YouTube content through a standardized interface.\n\n**Website:** [zubeidhendricks.github.io/youtube-mcp-server](https://zubeidhendricks.github.io/youtube-mcp-server/)\n\n## Available Tools\n\nThe server currently exposes 10 MCP tools.\n\n| Tool | Description | Required Parameters | Optional Parameters |\n|------|-------------|---------------------|---------------------|\n| `videos_getVideo` | Get detailed information about a YouTube video | `videoId` | `parts` |\n| `videos_searchVideos` | Search for videos on YouTube | `query` | `maxResults`, `order`, `publishedAfter`, `publishedBefore`, `channelId`, `uniqueChannels`, `channelMinSubscribers`, `channelMaxSubscribers`, `channelLastUploadAfter`, `channelLastUploadBefore`, `creatorOnly`, `sortBy` |\n| `transcripts_getTranscript` | Get the transcript of a YouTube video | `videoId` | `language` |\n| `channels_getChannel` | Get information about a YouTube channel | `channelId` | None |\n| `channels_getChannels` | Get information about multiple YouTube channels | `channelIds` | `parts`, `includeLatestUpload` |\n| `channels_searchChannels` | Search for YouTube channels by handle, name, or query | `query` | `maxResults`, `order`, `channelType`, `minSubscribers`, `maxSubscribers`, `lastUploadAfter`, `lastUploadBefore`, `creatorOnly`, `sortBy` |\n| `channels_findCreators` | Find creator channels from video mentions with channel-size and activity filters | `query` | `maxResults`, `order`, `videoPublishedAfter`, `videoPublishedBefore`, `channelMinSubscribers`, `channelMaxSubscribers`, `channelLastUploadAfter`, `channelLastUploadBefore`, `creatorOnly`, `sortBy`, `sampleVideosPerChannel` |\n| `channels_listVideos` | Get videos from a specific channel | `channelId` | `maxResults` |\n| `playlists_getPlaylist` | Get information about a YouTube playlist | `playlistId` | None |\n| `playlists_getPlaylistItems` | Get videos in a YouTube playlist | `playlistId` | `maxResults` |\n\n### Tool Parameters\n\n#### `videos_getVideo`\n- `videoId` (`string`): The YouTube video ID.\n- `parts` (`string[]`, optional): Specific video resource parts to retrieve.\n\n#### `videos_searchVideos`\n- `query` (`string`): Search query.\n- `maxResults` (`number`, optional): Maximum number of results to return.\n- `order` (`string`, optional): Result ordering such as `relevance` or `date`.\n- `publishedAfter` (`string`, optional): Only include videos published after this ISO 8601 date.\n- `publishedBefore` (`string`, optional): Only include videos published before this ISO 8601 date.\n- `channelId` (`string`, optional): Restrict results to a specific channel.\n- `uniqueChannels` (`boolean`, optional): Return only one video per unique channel.\n- `channelMinSubscribers` / `channelMaxSubscribers` (`number`, optional): Filter matched videos by the subscriber band of their channel.\n- `channelLastUploadAfter` / `channelLastUploadBefore` (`string`, optional): Filter matched videos by the latest upload activity of their channel.\n- `creatorOnly` (`boolean`, optional): Restrict results to channels heuristically classified as creators.\n- `sortBy` (`string`, optional): Supports `relevance`, `subscribers_asc`, `subscribers_desc`, `indie_priority`, and `recent_activity`.\n\n#### `transcripts_getTranscript`\n- `videoId` (`string`): The YouTube video ID.\n- `language` (`string`, optional): Transcript language code. Falls back to `YOUTUBE_TRANSCRIPT_LANG` or `en`.\n\n#### `channels_getChannel`\n- `channelId` (`string`): The YouTube channel ID.\n\nResponses now include:\n- `latestVideoPublishedAt`\n- `normalizedMetadata`\n  - includes `country`, `defaultLanguage`, `joinedAt`, `customUrl`, `emailsFound`, `contactLinks`, and creator-vs-brand heuristic fields\n\n#### `channels_getChannels`\n- `channelIds` (`string[]`): A list of YouTube channel IDs.\n- `includeLatestUpload` (`boolean`, optional): Whether to include `latestVideoPublishedAt`. Defaults to `true`.\n\n#### `channels_searchChannels`\n- `query` (`string`): Channel search query or handle.\n- `maxResults` (`number`, optional): Maximum number of channels to return.\n- `order` (`string`, optional): Result ordering such as `relevance`.\n- `channelType` (`string`, optional): Restrict the search to a channel type.\n- `minSubscribers` / `maxSubscribers` (`number`, optional): Filter channels by subscriber band.\n- `lastUploadAfter` / `lastUploadBefore` (`string`, optional): Filter channels by latest upload activity.\n- `creatorOnly` (`boolean`, optional): Restrict results to channels heuristically classified as creators.\n- `sortBy` (`string`, optional): Supports `relevance`, `subscribers_asc`, `subscribers_desc`, `indie_priority`, and `recent_activity`.\n\n#### `channels_findCreators`\n- `query` (`string`): Topic, game, or mention query to discover channels from matched videos.\n- `videoPublishedAfter` / `videoPublishedBefore` (`string`, optional): Recency filters for the matched videos.\n- `channelMinSubscribers` / `channelMaxSubscribers` (`number`, optional): Subscriber band filters for returned channels.\n- `channelLastUploadAfter` / `channelLastUploadBefore` (`string`, optional): Latest-upload activity filters for returned channels.\n- `creatorOnly` (`boolean`, optional): Restrict results to channels heuristically classified as creators.\n- `sortBy` (`string`, optional): Supports `relevance`, `subscribers_asc`, `subscribers_desc`, `indie_priority`, and `recent_activity`.\n- `sampleVideosPerChannel` (`number`, optional): How many matched videos to include per returned channel.\n\n#### `channels_listVideos`\n- `channelId` (`string`): The YouTube channel ID.\n- `maxResults` (`number`, optional): Maximum number of videos to return.\n\n#### `playlists_getPlaylist`\n- `playlistId` (`string`): The YouTube playlist ID.\n\n#### `playlists_getPlaylistItems`\n- `playlistId` (`string`): The YouTube playlist ID.\n- `maxResults` (`number`, optional): Maximum number of playlist items to return.\n\n## Installation\n\n### Quick Setup for Claude Desktop\n\n1. Install the package:\n```bash\nnpm install -g zubeid-youtube-mcp-server\n```\n\n2. Add to your Claude Desktop configuration (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS or `%APPDATA%\\Claude\\claude_desktop_config.json` on Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"zubeid-youtube-mcp-server\": {\n      \"command\": \"zubeid-youtube-mcp-server\",\n      \"env\": {\n        \"YOUTUBE_API_KEY\": \"your_primary_youtube_api_key\",\n        \"YOUTUBE_API_KEY2\": \"your_secondary_youtube_api_key\",\n        \"YOUTUBE_API_KEY3\": \"your_tertiary_youtube_api_key\"\n      }\n    }\n  }\n}\n```\n\n### Alternative: Using NPX (No Installation Required)\n\nAdd this to your Claude Desktop configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"youtube\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"zubeid-youtube-mcp-server\"],\n      \"env\": {\n        \"YOUTUBE_API_KEY\": \"your_primary_youtube_api_key\",\n        \"YOUTUBE_API_KEY2\": \"your_secondary_youtube_api_key\",\n        \"YOUTUBE_API_KEY3\": \"your_tertiary_youtube_api_key\"\n      }\n    }\n  }\n}\n```\n\n### Installing via Smithery\n\nTo install YouTube MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@ZubeidHendricks/youtube):\n\n```bash\nnpx -y @smithery/cli install @ZubeidHendricks/youtube --client claude\n```\n\n## Configuration\nSet the following environment variables:\n* `YOUTUBE_API_KEY`: Primary YouTube Data API key\n* `YOUTUBE_API_KEY2`: Secondary fallback API key\n* `YOUTUBE_API_KEY3`: Third fallback API key\n* `YOUTUBE_TRANSCRIPT_LANG`: Default language for transcripts (optional, defaults to 'en')\n\nAt least one of `YOUTUBE_API_KEY`, `YOUTUBE_API_KEY2`, or `YOUTUBE_API_KEY3` must be set. When a request fails because a key has exhausted its quota, the server retries the same request with the next configured key.\n\n### Using with VS Code\n\nFor one-click installation, click one of the install buttons below:\n\n[![Install with NPX in VS Code](https://img.shields.io/badge/VS_Code-NPM-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=youtube&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22zubeid-youtube-mcp-server%22%5D%2C%22env%22%3A%7B%22YOUTUBE_API_KEY%22%3A%22%24%7Binput%3AapiKey%7D%22%7D%7D&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22apiKey%22%2C%22description%22%3A%22YouTube+API+Key%22%2C%22password%22%3Atrue%7D%5D) [![Install with NPX in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-NPM-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=youtube&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22zubeid-youtube-mcp-server%22%5D%2C%22env%22%3A%7B%22YOUTUBE_API_KEY%22%3A%22%24%7Binput%3AapiKey%22%7D%7D&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22apiKey%22%2C%22description%22%3A%22YouTube+API+Key%22%2C%22password%22%3Atrue%7D%5D&quality=insiders)\n\n### Manual Installation\n\nIf you prefer manual installation, first check the install buttons at the top of this section. Otherwise, follow these steps:\n\nAdd the following JSON block to your User Settings (JSON) file in VS Code. You can do this by pressing `Ctrl + Shift + P` and typing `Preferences: Open User Settings (JSON)`.\n\n```json\n{\n  \"mcp\": {\n    \"inputs\": [\n      {\n        \"type\": \"promptString\",\n        \"id\": \"apiKey\",\n        \"description\": \"YouTube API Key\",\n        \"password\": true\n      }\n    ],\n    \"servers\": {\n      \"youtube\": {\n        \"command\": \"npx\",\n        \"args\": [\"-y\", \"zubeid-youtube-mcp-server\"],\n        \"env\": {\n          \"YOUTUBE_API_KEY\": \"${input:apiKey}\"\n        }\n      }\n    }\n  }\n}\n```\n\nOptionally, you can add it to a file called `.vscode/mcp.json` in your workspace:\n\n```json\n{\n  \"inputs\": [\n    {\n      \"type\": \"promptString\",\n      \"id\": \"apiKey\",\n      \"description\": \"YouTube API Key\",\n      \"password\": true\n    }\n  ],\n  \"servers\": {\n    \"youtube\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"zubeid-youtube-mcp-server\"],\n      \"env\": {\n        \"YOUTUBE_API_KEY\": \"${input:apiKey}\"\n      }\n    }\n  }\n}\n```\n\n## Development\n\n```bash\n# Install dependencies\nnpm install\n\n# Build\nnpm run build\n\n# Start the server (requires at least one configured YouTube API key)\nnpm start\n\n# Development mode with auto-rebuild\nnpm run dev\n```\n\n## Docker\n\nThe included Docker image starts the server over HTTP by default.\n\n- Default transport: `http`\n- Default endpoint: `http://localhost:8088/mcp`\n- Readiness endpoint: `http://localhost:8088/ready`\n- Default mode: stateless\n\nThe Docker build copies `.env` into the runtime image and the server loads it automatically on startup. That means the container can run without passing API credentials at `docker run` time, as long as `.env` was present during `docker build`.\n\n```bash\ndocker build -t youtube-mcp-server .\ndocker run --rm -p 8088:8088 youtube-mcp-server\n```\n\nThe container defaults to:\n\n```env\nMCP_TRANSPORT=http\nMCP_HOST=0.0.0.0\nMCP_PORT=8088\nMCP_STATELESS=true\n```\n\n## Contributing\nSee CONTRIBUTING.md for information about contributing to this repository.\n\n## License\nThis project is licensed under the MIT License - see the LICENSE file for details.\n","readmeFilename":"README.md"}