Skip to main content
Glama

ytt-mcp: YouTube Transcript MCP Server

MCP Server to fetch transcripts for YouTube videos.

Installing and Running

The most convenient way to install and run is to use uv and then invoke the package using uvx

Related MCP server: youtube-mcp

Using MCP Inspector (for development/debugging/testing only)

uv run fastmcp dev ytt_mcp.py

This will generate a localhost URL that can be used to examine and test out the server.

Claude Desktop

Go to SettingsDeveloper, and then click on Edit Config. This will open the claude-desktop-config.json file in your default editor. Make the following addition

{
  "mcpServers": {
    …<rest of the config>…
    "ytt-mcp": {
      "command": "uvx",
      "args": ["ytt-mcp"]
    }
  }
}

Relaunch Claude config and try out the server as shown in the screenshot below

Raycast

If you are using Raycast, you can install the MCP server by invoking the Install Server command from the MCP extension.

After that you can refer to the MCP server as @youtube-transcript and interact with it. You can also use it in a Raycast AI Command with a prompt. For example, here is a prompt I use to extract and summarize a YouTube URL in the clipboard

@youtube-transcript fetch the Youtube transcript of the video: {clipboard | raw}

Comprehensively summarize the transcript with the following format:
"""
### Key Takeaways

- <EXACTLY three bullet points with the key takeaways, keep the bullet points as short as possible>
"""

### Theme Wise Breakdown
<divide the transcript into thematic sections and summarize each section comprehensively. reuse any existing section delimiters the article already has. If not add your own. keep the content of the breakdown in the same order as it appears in the webpage text.>

Some rules to follow precisely:
- ALWAYS capture the perspective and POV of the author
- NEVER come up with additional information

See video demo below

https://github.com/user-attachments/assets/e6530768-3483-4cb9-988a-7ec7a999d505

Available Tools

1 tool
get_youtube_transcriptB

Get the transcript of a YouTube video

ParametersJSON Schema
NameRequiredDescriptionDefault
urlYesYouTube URL or video ID
langNoLanguage code for transcript (e.g., 'en', 'fr', 'de', 'es')en

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3.2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description must disclose behaviors. It only states the basic function, omitting potential failures like missing transcripts, authentication needs, or rate limits.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single clear sentence with no superfluous words, but lacks structure or elaboration.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's simplicity and the presence of an output schema, the description is minimally adequate, but does not cover edge cases or prerequisites.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the schema already documents parameters. The description adds no extra meaning beyond what is in the schema, resulting in a baseline score of 3.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description clearly states the action 'Get' and the resource 'transcript of a YouTube video', making the purpose unambiguous.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool or alternatives. No context about prerequisites or conditions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 1 tool updatev0.1.0
    • First observedget_youtube_transcript

TDQS

B3.3/5.0

Scored across 1 tool

Disambiguation5/5

With only one tool, there is no possibility of ambiguity or overlap between tools, as there are no other tools to compare it to. The tool's purpose is clearly distinct by default.

Naming Consistency5/5

Since there is only one tool, naming consistency is inherently perfect; there are no other tools to create inconsistency or mixed conventions. The tool name follows a clear verb_noun pattern.

Tool Count2/5

A single tool is too few for most practical server purposes, as it severely limits functionality and scope. This feels thin and incomplete for a YouTube-related server, which might typically include operations like search, list, or metadata retrieval.

Completeness2/5

The tool surface is severely incomplete for a YouTube domain; it only provides transcript retrieval with no support for other common operations like video search, channel information, or playlist management. This will cause significant agent failures in broader tasks.

Maintenance

ActivityInactive
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    D
    maintenance
    An MCP server that enables users to retrieve YouTube transcripts and perform video or channel searches without requiring Google API keys. It supports transcript chunking and provides tools for detailed video content analysis and channel metadata extraction.
    5
    56 npm
    4
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    An MCP server that enables the extraction of transcripts and detailed metadata from YouTube videos. It allows users to retrieve video information like titles and descriptions, as well as transcripts with optional timestamps and language selection.
    2
    MIT
  • A
    license
    A
    quality
    A
    maintenance
    MCP server that fetches YouTube video transcripts and optionally summarizes them. Supports multiple transcript formats (text, JSON, SRT, WebVTT), multi-language retrieval, and flexible YouTube URL parsing.
    6
    6
    MIT