YouTube Transcript MCP MCP Server

Download transcripts directly from YouTube videos.

Local serverstdioTypeScript

What is the YouTube Transcript MCP MCP server?

Download transcripts directly from YouTube videos. Exposed over MCP by the youtube transcript mcp mcp server, that capability becomes something an assistant can invoke while it works, not something you go and do afterwards.

What it actually does

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.

  • Support for multiple video URL formats (including YouTube Shorts)
  • Language-specific transcript retrieval with automatic fallback
  • Optional timestamps for referencing specific moments
  • Built-in ad/sponsorship filtering (enabled by default)
  • Zero external dependencies for transcript fetching
  • Detailed metadata in responses

Its toolset

Everything the assistant can do here goes through one of these:

  • get_transcript — Extract transcripts from YouTube videos
  • Inputs — - url (string, required): YouTube video URL, Shorts URL, or video ID
  • Tools — The Tools tool exposed by this server
  • Prerequisites — The Prerequisites tool exposed by this server
  • Setup — For development with auto-rebuild: bash npm run watch
  • Testing — The Testing tool exposed by this server
  • Debugging — Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector for development:

Configuration

You will need 3 environment variables: TWELVELABS_API_KEY, OPENAI_API_KEY, VIDEO_ID. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

  • Node.js 18 or higher - npm or yarn

Adding it to your client

@smithery/cli on npm is all you need. Most clients run it directly, so configuration is a few lines and a restart.

When to reach for it

Plenty of developer tooling servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. YouTube Transcript MCP's toolset — get_transcript, Inputs, Tools and 4 more — is a fair guide to whether it matches your workflow.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the youtube transcript mcp mcp server does with a few real requests.

Available tools

ToolWhat it does
get_transcriptExtract transcripts from YouTube videos
Inputs- url (string, required): YouTube video URL, Shorts URL, or video ID
ToolsThe Tools tool exposed by this server.
PrerequisitesThe Prerequisites tool exposed by this server.
SetupFor development with auto-rebuild: bash npm run watch
TestingThe Testing tool exposed by this server.
DebuggingSince MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector for development:

How to install the YouTube Transcript MCP MCP server

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "npx",
      "args": ["-y", "@kimtaeyoon83/mcp-server-youtube-transcript"]
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

  • Node.js 18 or higher - npm or yarn
VariableDescriptionRequired
TWELVELABS_API_KEYCredential the server authenticates with.Yes
OPENAI_API_KEYCredential the server authenticates with.Yes
VIDEO_IDConfiguration value read at startup.Optional

Example prompts to try

  • Use YouTube Transcript MCP to get transcript.
  • Use YouTube Transcript MCP to Inputs.
  • Use YouTube Transcript MCP to Tools.

Frequently asked questions

It connects YouTube Transcript MCP to MCP-compatible AI assistants such as Claude and Cursor, exposing 7 tools (get_transcript, Inputs, Tools, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with YouTube Transcript MCP directly.