{"_id":"@claudium/youtube-mcp-server","name":"@claudium/youtube-mcp-server","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@claudium/youtube-mcp-server","version":"1.0.0","description":"YouTube MCP Server Implementation - Model Context Protocol server for YouTube integration","type":"module","main":"dist/index.js","bin":{"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"},"dependencies":{"@modelcontextprotocol/sdk":"^1.1.1","googleapis":"^129.0.0","ytdl-core":"^4.11.5","youtube-transcript":"^1.0.6"},"devDependencies":{"@types/node":"^18.0.0","typescript":"^5.0.0","ts-node":"^10.9.1","nodemon":"^3.0.0"},"keywords":["youtube","mcp","model-context-protocol","ai","claude","anthropic"],"author":{"name":"Claudiu Mihaila"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/iclaudiumihaila/youtube-mcp-server.git"},"bugs":{"url":"https://github.com/iclaudiumihaila/youtube-mcp-server/issues"},"homepage":"https://github.com/iclaudiumihaila/youtube-mcp-server#readme","_id":"@claudium/youtube-mcp-server@1.0.0","gitHead":"414719127607b4834b67e7409d2ffbeb1143fe86","types":"./dist/index.d.ts","_nodeVersion":"22.16.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-SPN3oBt6wPmIOMZFSgUYyjcsek9JeV9uReftdCfngJGLInWU86WHGOB+L5qpEb4b4SGjjfqxbavD/M0nlRRa0Q==","shasum":"ff6e71ddeb6f9af21a1c3135f0055757b121f03f","tarball":"https://registry.npmjs.org/@claudium/youtube-mcp-server/-/youtube-mcp-server-1.0.0.tgz","fileCount":18,"unpackedSize":35076,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCID6nquOtS5+QXGSwXB3uflb7haMOI2wKpCyBvypigv6yAiAfZS//3IiOpXAfhrJW3KFMY5Q3jmiNFNslkzSgnsZ0qA=="}]},"_npmUser":{"name":"claudium","email":"iclaudiumihaila@gmail.com"},"directories":{},"maintainers":[{"name":"claudium","email":"iclaudiumihaila@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/youtube-mcp-server_1.0.0_1756874258485_0.9881963011767323"},"_hasShrinkwrap":false}},"time":{"created":"2025-09-03T04:37:38.435Z","1.0.0":"2025-09-03T04:37:38.738Z","modified":"2025-09-03T04:37:38.953Z"},"maintainers":[{"name":"claudium","email":"iclaudiumihaila@gmail.com"}],"description":"YouTube MCP Server Implementation - Model Context Protocol server for YouTube integration","homepage":"https://github.com/iclaudiumihaila/youtube-mcp-server#readme","keywords":["youtube","mcp","model-context-protocol","ai","claude","anthropic"],"repository":{"type":"git","url":"git+https://github.com/iclaudiumihaila/youtube-mcp-server.git"},"author":{"name":"Claudiu Mihaila"},"bugs":{"url":"https://github.com/iclaudiumihaila/youtube-mcp-server/issues"},"license":"MIT","readme":"# 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## Features\n\n### Video Information\n* Get video details (title, description, duration, etc.)\n* List channel videos\n* Get video statistics (views, likes, comments)\n* Search videos across YouTube\n\n### Transcript Management\n* Retrieve video transcripts\n* Support for multiple languages\n* Get timestamped captions\n* Search within transcripts\n\n### Channel Management\n* Get channel details\n* List channel playlists\n* Get channel statistics\n* Search within channel content\n\n### Playlist Management\n* List playlist items\n* Get playlist details\n* Search within playlists\n* Get playlist video transcripts\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_youtube_api_key_here\"\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_youtube_api_key_here\"\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`: Your YouTube Data API key (required)\n* `YOUTUBE_TRANSCRIPT_LANG`: Default language for transcripts (optional, defaults to 'en')\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%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&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## YouTube API Setup\n1. Go to Google Cloud Console\n2. Create a new project or select an existing one\n3. Enable the YouTube Data API v3\n4. Create API credentials (API key)\n5. Copy the API key for configuration\n\n## Examples\n\n### Managing Videos\n\n```javascript\n// Get video details\nconst video = await youtube.videos.getVideo({\n  videoId: \"video-id\"\n});\n\n// Get video transcript\nconst transcript = await youtube.transcripts.getTranscript({\n  videoId: \"video-id\",\n  language: \"en\"\n});\n\n// Search videos\nconst searchResults = await youtube.videos.searchVideos({\n  query: \"search term\",\n  maxResults: 10\n});\n```\n\n### Managing Channels\n\n```javascript\n// Get channel details\nconst channel = await youtube.channels.getChannel({\n  channelId: \"channel-id\"\n});\n\n// List channel videos\nconst videos = await youtube.channels.listVideos({\n  channelId: \"channel-id\",\n  maxResults: 50\n});\n```\n\n### Managing Playlists\n\n```javascript\n// Get playlist items\nconst playlistItems = await youtube.playlists.getPlaylistItems({\n  playlistId: \"playlist-id\",\n  maxResults: 50\n});\n\n// Get playlist details\nconst playlist = await youtube.playlists.getPlaylist({\n  playlistId: \"playlist-id\"\n});\n```\n\n## Development\n\n```bash\n# Install dependencies\nnpm install\n\n# Run tests\nnpm test\n\n# Build\nnpm run build\n\n# Lint\nnpm run lint\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","_rev":"1-107a5a4394737a74a70f0a99e9461da0"}