Skip to content
Back to search

youtube-mcp-server

MCP Server for YouTube API, enabling video management, Shorts creation, and advanced analytics

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/zubeidhendricks--youtube-mcp-server/badge.svg)](/listings/zubeidhendricks--youtube-mcp-server)

HTML

<a href="/listings/zubeidhendricks--youtube-mcp-server"><img src="/api/listings/zubeidhendricks--youtube-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Quick Setup for Claude Desktop

1. Install the package:

npm install -g zubeid-youtube-mcp-server

2. 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):

{
  "mcpServers": {
    "zubeid-youtube-mcp-server": {
      "command": "zubeid-youtube-mcp-server",
      "env": {
        "YOUTUBE_API_KEY": "your_primary_youtube_api_key",
        "YOUTUBE_API_KEY2": "your_secondary_youtube_api_key",
        "YOUTUBE_API_KEY3": "your_tertiary_youtube_api_key"
      }
    }
  }
}

Alternative: Using NPX (No Installation Required)

Add this to your Claude Desktop configuration:

{
  "mcpServers": {
    "youtube": {
      "command": "npx",
      "args": ["-y", "zubeid-youtube-mcp-server"],
      "env": {
        "YOUTUBE_API_KEY": "your_primary_youtube_api_key",
        "YOUTUBE_API_KEY2": "your_secondary_youtube_api_key",
        "YOUTUBE_API_KEY3": "your_tertiary_youtube_api_key"
      }
    }
  }
}

Installing via Smithery

To install YouTube MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@ZubeidHendricks/youtube):

npx -y @smithery/cli install @ZubeidHendricks/youtube --client claude

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 261 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # YouTube MCP Server
  2. [![npm version](https://img.shields.io/npm/v/zubeid-youtube-mcp-server)](https://www.npmjs.com/package/zubeid-youtube-mcp-server)
  3. [![npm downloads](https://img.shields.io/npm/dm/zubeid-youtube-mcp-server?label=downloads%2Fmonth)](https://www.npmjs.com/package/zubeid-youtube-mcp-server)
  4. [![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)
  5. A Model Context Protocol (MCP) server implementation for YouTube, enabling AI language models to interact with YouTube content through a standardized interface.
  6. **Website:** [zubeidhendricks.github.io/youtube-mcp-server](https://zubeidhendricks.github.io/youtube-mcp-server/)
  7. ## Available Tools
  8. The server currently exposes 10 MCP tools.
  9. | Tool | Description | Required Parameters | Optional Parameters |
  10. |------|-------------|---------------------|---------------------|
  11. | `videos_getVideo` | Get detailed information about a YouTube video | `videoId` | `parts` |
  12. | `videos_searchVideos` | Search for videos on YouTube | `query` | `maxResults`, `order`, `publishedAfter`, `publishedBefore`, `channelId`, `uniqueChannels`, `channelMinSubscribers`, `channelMaxSubscribers`, `channelLastUploadAfter`, `channelLastUploadBefore`, `creatorOnly`, `sortBy` |
  13. | `transcripts_getTranscript` | Get the transcript of a YouTube video | `videoId` | `language` |
  14. | `channels_getChannel` | Get information about a YouTube channel | `channelId` | None |
  15. | `channels_getChannels` | Get information about multiple YouTube channels | `channelIds` | `parts`, `includeLatestUpload` |
  16. | `channels_searchChannels` | Search for YouTube channels by handle, name, or query | `query` | `maxResults`, `order`, `channelType`, `minSubscribers`, `maxSubscribers`, `lastUploadAfter`, `lastUploadBefore`, `creatorOnly`, `sortBy` |
  17. | `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` |
  18. | `channels_listVideos` | Get videos from a specific channel | `channelId` | `maxResults` |
  19. | `playlists_getPlaylist` | Get information about a YouTube playlist | `playlistId` | None |
  20. | `playlists_getPlaylistItems` | Get videos in a YouTube playlist | `playlistId` | `maxResults` |
  21. ### Tool Parameters
  22. #### `videos_getVideo`
  23. - `videoId` (`string`): The YouTube video ID.
  24. - `parts` (`string[]`, optional): Specific video resource parts to retrieve.
  25. #### `videos_searchVideos`
  26. - `query` (`string`): Search query.
  27. - `maxResults` (`number`, optional): Maximum number of results to return.
  28. - `order` (`string`, optional): Result ordering such as `relevance` or `date`.
  29. - `publishedAfter` (`string`, optional): Only include videos published after this ISO 8601 date.
  30. - `publishedBefore` (`string`, optional): Only include videos published before this ISO 8601 date.
  31. - `channelId` (`string`, optional): Restrict results to a specific channel.
  32. - `uniqueChannels` (`boolean`, optional): Return only one video per unique channel.
  33. - `channelMinSubscribers` / `channelMaxSubscribers` (`number`, optional): Filter matched videos by the subscriber band of their channel.
  34. - `channelLastUploadAfter` / `channelLastUploadBefore` (`string`, optional): Filter matched videos by the latest upload activity of their channel.
  35. - `creatorOnly` (`boolean`, optional): Restrict results to channels heuristically classified as creators.
  36. - `sortBy` (`string`, optional): Supports `relevance`, `subscribers_asc`, `subscribers_desc`, `indie_priority`, and `recent_activity`.
  37. #### `transcripts_getTranscript`
  38. - `videoId` (`string`): The YouTube video ID.
  39. - `language` (`string`, optional): Transcript language code. Falls back to `YOUTUBE_TRANSCRIPT_LANG` or `en`.
  40. #### `channels_getChannel`
  41. - `channelId` (`string`): The YouTube channel ID.
  42. Responses now include:
  43. - `latestVideoPublishedAt`
  44. - `normalizedMetadata`
  45. - includes `country`, `defaultLanguage`, `joinedAt`, `customUrl`, `emailsFound`, `contactLinks`, and creator-vs-brand heuristic fields
  46. #### `channels_getChannels`
  47. - `channelIds` (`string[]`): A list of YouTube channel IDs.
  48. - `includeLatestUpload` (`boolean`, optional): Whether to include `latestVideoPublishedAt`. Defaults to `true`.
  49. #### `channels_searchChannels`
  50. - `query` (`string`): Channel search query or handle.
  51. - `maxResults` (`number`, optional): Maximum number of channels to return.
  52. - `order` (`string`, optional): Result ordering such as `relevance`.
  53. - `channelType` (`string`, optional): Restrict the search to a channel type.
  54. - `minSubscribers` / `maxSubscribers` (`number`, optional): Filter channels by subscriber band.
  55. - `lastUploadAfter` / `lastUploadBefore` (`string`, optional): Filter channels by latest upload activity.
  56. - `creatorOnly` (`boolean`, optional): Restrict results to channels heuristically classified as creators.
  57. - `sortBy` (`string`, optional): Supports `relevance`, `subscribers_asc`, `subscribers_desc`, `indie_priority`, and `recent_activity`.
  58. #### `channels_findCreators`
  59. - `query` (`string`): Topic, game, or mention query to discover channels from matched videos.
  60. - `videoPublishedAfter` / `videoPublishedBefore` (`string`, optional): Recency filters for the matched videos.
  61. - `channelMinSubscribers` / `channelMaxSubscribers` (`number`, optional): Subscriber band filters for returned channels.
  62. - `channelLastUploadAfter` / `channelLastUploadBefore` (`string`, optional): Latest-upload activity filters for returned channels.
  63. - `creatorOnly` (`boolean`, optional): Restrict results to channels heuristically classified as creators.
  64. - `sortBy` (`string`, optional): Supports `relevance`, `subscribers_asc`, `subscribers_desc`, `indie_priority`, and `recent_activity`.
  65. - `sampleVideosPerChannel` (`number`, optional): How many matched videos to include per returned channel.
  66. #### `channels_listVideos`
  67. - `channelId` (`string`): The YouTube channel ID.
  68. - `maxResults` (`number`, optional): Maximum number of videos to return.
  69. #### `playlists_getPlaylist`
  70. - `playlistId` (`string`): The YouTube playlist ID.
  71. #### `playlists_getPlaylistItems`
  72. - `playlistId` (`string`): The YouTube playlist ID.
  73. - `maxResults` (`number`, optional): Maximum number of playlist items to return.
  74. ## Installation
  75. ### Quick Setup for Claude Desktop
  76. 1. Install the package:
  77. ```bash
  78. npm install -g zubeid-youtube-mcp-server
  79. ```
  80. 2. 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):
  81. ```json
  82. {
  83. "mcpServers": {
  84. "zubeid-youtube-mcp-server": {
  85. "command": "zubeid-youtube-mcp-server",
  86. "env": {
  87. "YOUTUBE_API_KEY": "your_primary_youtube_api_key",
  88. "YOUTUBE_API_KEY2": "your_secondary_youtube_api_key",
  89. "YOUTUBE_API_KEY3": "your_tertiary_youtube_api_key"
  90. }
  91. }
  92. }
  93. }
  94. ```
  95. ### Alternative: Using NPX (No Installation Required)
  96. Add this to your Claude Desktop configuration:
  97. ```json
  98. {
  99. "mcpServers": {
  100. "youtube": {
  101. "command": "npx",
  102. "args": ["-y", "zubeid-youtube-mcp-server"],
  103. "env": {
  104. "YOUTUBE_API_KEY": "your_primary_youtube_api_key",
  105. "YOUTUBE_API_KEY2": "your_secondary_youtube_api_key",
  106. "YOUTUBE_API_KEY3": "your_tertiary_youtube_api_key"
  107. }
  108. }
  109. }
  110. }
  111. ```
  112. ### Installing via Smithery
  113. To install YouTube MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@ZubeidHendricks/youtube):
  114. ```bash
  115. npx -y @smithery/cli install @ZubeidHendricks/youtube --client claude
  116. ```
  117. ## Configuration
  118. Set the following environment variables:
  119. * `YOUTUBE_API_KEY`: Primary YouTube Data API key
  120. * `YOUTUBE_API_KEY2`: Secondary fallback API key
  121. * `YOUTUBE_API_KEY3`: Third fallback API key
  122. * `YOUTUBE_TRANSCRIPT_LANG`: Default language for transcripts (optional, defaults to 'en')
  123. At 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.
  124. ### Using with VS Code
  125. For one-click installation, click one of the install buttons below:
  126. [![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)
  127. ### Manual Installation
  128. If you prefer manual installation, first check the install buttons at the top of this section. Otherwise, follow these steps:
  129. Add 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)`.
  130. ```json
  131. {
  132. "mcp": {
  133. "inputs": [
  134. {
  135. "type": "promptString",
  136. "id": "apiKey",
  137. "description": "YouTube API Key",
  138. "password": true
  139. }
  140. ],
  141. "servers": {
  142. "youtube": {
  143. "command": "npx",
  144. "args": ["-y", "zubeid-youtube-mcp-server"],
  145. "env": {
  146. "YOUTUBE_API_KEY": "${input:apiKey}"
  147. }
  148. }
  149. }
  150. }
  151. }
  152. ```
  153. Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace:
  154. ```json
  155. {
  156. "inputs": [
  157. {
  158. "type": "promptString",
  159. "id": "apiKey",
  160. "description": "YouTube API Key",
  161. "password": true
  162. }
  163. ],
  164. "servers": {
  165. "youtube": {
  166. "command": "npx",
  167. "args": ["-y", "zubeid-youtube-mcp-server"],
  168. "env": {
  169. "YOUTUBE_API_KEY": "${input:apiKey}"
  170. }
  171. }
  172. }
  173. }
  174. ```
  175. ## Development
  176. ```bash
  177. # Install dependencies
  178. npm install
  179. # Build
  180. npm run build
  181. # Start the server (requires at least one configured YouTube API key)
  182. npm start
  183. # Development mode with auto-rebuild
  184. npm run dev
  185. ```
  186. ## Docker
  187. The included Docker image starts the server over HTTP by default.
  188. - Default transport: `http`
  189. - Default endpoint: `http://localhost:8088/mcp`
  190. - Readiness endpoint: `http://localhost:8088/ready`
  191. - Default mode: stateless
  192. The 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`.
  193. ```bash
  194. docker build -t youtube-mcp-server .
  195. docker run --rm -p 8088:8088 youtube-mcp-server
  196. ```
  197. The container defaults to:
  198. ```env
  199. MCP_TRANSPORT=http
  200. MCP_HOST=0.0.0.0
  201. MCP_PORT=8088
  202. MCP_STATELESS=true
  203. ```
  204. ## Contributing
  205. See CONTRIBUTING.md for information about contributing to this repository.
  206. ## License
  207. This project is licensed under the MIT License - see the LICENSE file for details.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.