Skip to content
Back to search

mcp-server-youtube-transcript

This is an MCP server that allows you to directly download transcripts of YouTube videos.

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/kimtaeyoon83--mcp-server-youtube-transcript/badge.svg)](/listings/kimtaeyoon83--mcp-server-youtube-transcript)

HTML

<a href="/listings/kimtaeyoon83--mcp-server-youtube-transcript"><img src="/api/listings/kimtaeyoon83--mcp-server-youtube-transcript/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.

To install YouTube Transcript Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@kimtaeyoon83/mcp-server-youtube-transcript):

npx -y @smithery/cli install @kimtaeyoon83/mcp-server-youtube-transcript --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 · 203 lines

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

  1. [![MseeP.ai Security Assessment Badge](https://mseep.net/pr/kimtaeyoon83-mcp-server-youtube-transcript-badge.png)](https://mseep.ai/app/kimtaeyoon83-mcp-server-youtube-transcript)
  2. # YouTube Transcript Server
  3. [![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/kimtaeyoon83/mcp-server-youtube-transcript)](https://archestra.ai/mcp-catalog/kimtaeyoon83__mcp-server-youtube-transcript)
  4. [![smithery badge](https://smithery.ai/badge/@kimtaeyoon83/mcp-server-youtube-transcript)](https://smithery.ai/server/@kimtaeyoon83/mcp-server-youtube-transcript)
  5. A Model Context Protocol server that enables retrieval of transcripts from YouTube videos. This server provides direct access to video captions and subtitles through a simple interface.
  6. <a href="https://glama.ai/mcp/servers/z429kk3te7"><img width="380" height="200" src="https://glama.ai/mcp/servers/z429kk3te7/badge" alt="mcp-server-youtube-transcript MCP server" /></a>
  7. ### Installing via Smithery
  8. To install YouTube Transcript Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@kimtaeyoon83/mcp-server-youtube-transcript):
  9. ```bash
  10. npx -y @smithery/cli install @kimtaeyoon83/mcp-server-youtube-transcript --client claude
  11. ```
  12. ## Components
  13. ### Tools
  14. - **get_transcript**
  15. - Extract transcripts from YouTube videos
  16. - Inputs:
  17. - `url` (string, required): YouTube video URL, Shorts URL, or video ID
  18. - `lang` (string, optional, default: "en"): Language code for transcript (e.g., 'ko', 'en'). Automatically falls back to available languages if requested language is not found.
  19. - `include_timestamps` (boolean, optional, default: false): Include timestamps in output (e.g., '[0:05] text')
  20. - `strip_ads` (boolean, optional, default: true): Filter out sponsorships, ads, and promotional content from transcript based on chapter markers
  21. - **analyze_video** (optional, requires a TwelveLabs API key)
  22. - Analyze a video with [TwelveLabs](https://twelvelabs.io) Pegasus, a video-understanding model. Unlike `get_transcript`, this reasons over what is *shown* on screen, so it produces useful summaries and answers even for videos with little or no speech (demos, gameplay, b-roll, music videos).
  23. - Inputs:
  24. - `url` (string, required): A publicly reachable **direct video URL** (e.g. an `.mp4`/`.mov`/`.webm` link or a pre-signed URL). TwelveLabs fetches the file server-side, so a YouTube watch page URL will not work — it serves HTML, not a raw video stream.
  25. - `prompt` (string, optional): Instruction or question for the model (e.g. `"Summarize this video in 3 sentences"` or `"What products are shown?"`). Defaults to a general summary.
  26. - `model` (string, optional, default: `"pegasus1.2"`): Pegasus model to use (`"pegasus1.2"` or `"pegasus1.5"`).
  27. - `max_tokens` (number, optional, default: 2048): Maximum response length in tokens.
  28. - Requires the `TWELVELABS_API_KEY` environment variable. The transcript tool works without it; analysis is fully opt-in. Grab a free key at [twelvelabs.io](https://twelvelabs.io) — there's a generous free tier.
  29. ## Key Features
  30. - Support for multiple video URL formats (including YouTube Shorts)
  31. - Language-specific transcript retrieval with automatic fallback
  32. - Optional timestamps for referencing specific moments
  33. - Built-in ad/sponsorship filtering (enabled by default)
  34. - Zero external dependencies for transcript fetching
  35. - Detailed metadata in responses
  36. ## Configuration
  37. To use with Claude Desktop, add this server configuration:
  38. ```json
  39. {
  40. "mcpServers": {
  41. "youtube-transcript": {
  42. "command": "npx",
  43. "args": ["-y", "@kimtaeyoon83/mcp-server-youtube-transcript"]
  44. }
  45. }
  46. }
  47. ```
  48. To enable the optional `analyze_video` tool, add your TwelveLabs API key:
  49. ```json
  50. {
  51. "mcpServers": {
  52. "youtube-transcript": {
  53. "command": "npx",
  54. "args": ["-y", "@kimtaeyoon83/mcp-server-youtube-transcript"],
  55. "env": {
  56. "TWELVELABS_API_KEY": "your-twelvelabs-api-key"
  57. }
  58. }
  59. }
  60. }
  61. ```
  62. ## Install via tool
  63. [mcp-get](https://github.com/michaellatman/mcp-get) A command-line tool for installing and managing Model Context Protocol (MCP) servers.
  64. ```shell
  65. npx @michaellatman/mcp-get@latest install @kimtaeyoon83/mcp-server-youtube-transcript
  66. ```
  67. ## Awesome-mcp-servers
  68. [awesome-mcp-servers](https://github.com/punkpeye/awesome-mcp-servers) A curated list of awesome Model Context Protocol (MCP) servers.
  69. ## Development
  70. ### Prerequisites
  71. - Node.js 18 or higher
  72. - npm or yarn
  73. ### Setup
  74. Install dependencies:
  75. ```bash
  76. npm install
  77. ```
  78. Build the server:
  79. ```bash
  80. npm run build
  81. ```
  82. For development with auto-rebuild:
  83. ```bash
  84. npm run watch
  85. ```
  86. ### Testing
  87. ```bash
  88. npm test
  89. ```
  90. ### Debugging
  91. Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector for development:
  92. ```bash
  93. npm run inspector
  94. ```
  95. ## Running evals
  96. The evals package loads an mcp client that then runs the index.ts file, so there is no need to rebuild between tests. You can load environment variables by prefixing the npx command. Full documentation can be found [here](https://www.mcpevals.io/docs).
  97. ```bash
  98. OPENAI_API_KEY=your-key npx mcp-eval src/evals/evals.ts src/index.ts
  99. ```
  100. ## Error Handling
  101. The server implements robust error handling for common scenarios:
  102. - Invalid video URLs or IDs
  103. - Unavailable transcripts
  104. - Language availability issues
  105. - Network errors
  106. ## Usage Examples
  107. 1. Get transcript by video URL:
  108. ```typescript
  109. await server.callTool("get_transcript", {
  110. url: "https://www.youtube.com/watch?v=VIDEO_ID",
  111. lang: "en"
  112. });
  113. ```
  114. 2. Get transcript by video ID:
  115. ```typescript
  116. await server.callTool("get_transcript", {
  117. url: "VIDEO_ID",
  118. lang: "ko"
  119. });
  120. ```
  121. 3. Get transcript from YouTube Shorts:
  122. ```typescript
  123. await server.callTool("get_transcript", {
  124. url: "https://www.youtube.com/shorts/VIDEO_ID"
  125. });
  126. ```
  127. 4. Get transcript with timestamps:
  128. ```typescript
  129. await server.callTool("get_transcript", {
  130. url: "VIDEO_ID",
  131. include_timestamps: true
  132. });
  133. ```
  134. 5. Get raw transcript without ad filtering:
  135. ```typescript
  136. await server.callTool("get_transcript", {
  137. url: "VIDEO_ID",
  138. strip_ads: false
  139. });
  140. ```
  141. 6. How to Extract YouTube Subtitles in Claude Desktop App
  142. ```
  143. chat: https://youtu.be/ODaHJzOyVCQ?si=aXkJgso96Deri0aB Extract subtitles
  144. ```
  145. ## Security Considerations
  146. The server:
  147. - Validates all input parameters
  148. - Handles YouTube API errors gracefully
  149. - Implements timeouts for transcript retrieval
  150. - Provides detailed error messages for troubleshooting
  151. ## License
  152. This MCP server 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.