Skip to main content
Glama
fetchtranscript-mcp

fetchtranscript-mcp

Official

FetchTranscript MCP Server

An MCP server that gives AI assistants (Claude Desktop, Cursor, etc.) access to YouTube transcripts, video metadata, channels, and search via the FetchTranscript API.

Features

8 Tools — get transcripts, list languages, video metadata, chapters, comments, channel info, channel videos, search

4 Documentation Resources — API reference, quickstart guide, pricing, workflow examples

3 Prompt Templates — summarize video, compare videos, extract quotes

Related MCP server: youtube-transcript-mcp

Quick Start

1. Get an API Key

Sign up at fetchtranscript.com and create an API key from the dashboard.

2. Configure Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "fetchtranscript": {
      "command": "uvx",
      "args": ["fetchtranscript-mcp"],
      "env": {
        "FETCHTRANSCRIPT_API_KEY": "yt_your_key_here"
      }
    }
  }
}

3. Use it

Ask Claude:

  • "Get the transcript of YouTube video dQw4w9WgXcQ"

  • "Summarize this YouTube video: https://youtube.com/watch?v=..."

  • "Search YouTube for 'machine learning explained' and summarize the top result"

Configuration for Other Clients

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "fetchtranscript": {
      "command": "uvx",
      "args": ["fetchtranscript-mcp"],
      "env": {
        "FETCHTRANSCRIPT_API_KEY": "yt_your_key_here"
      }
    }
  }
}

Claude Code

claude mcp add fetchtranscript -- uvx fetchtranscript-mcp

Set FETCHTRANSCRIPT_API_KEY in your environment.

Installation Alternatives

pip

pip install fetchtranscript-mcp
FETCHTRANSCRIPT_API_KEY=yt_xxx fetchtranscript-mcp

npx

FETCHTRANSCRIPT_API_KEY=yt_xxx npx fetchtranscript-mcp

Tools

Tool

Description

Key defaults

get_transcript

Fetch video transcript

format=text

list_languages

Available transcript languages

—

get_video_metadata

Video title, views, likes, etc.

—

get_chapters

Video chapter list

—

get_comments

Top comments

limit=20

get_channel_info

Channel metadata

—

list_channel_videos

Videos from a channel

limit=10

search_videos

Search YouTube

limit=5

Environment Variables

Variable

Required

Description

FETCHTRANSCRIPT_API_KEY

Yes

Your API key (starts with yt_)

FETCHTRANSCRIPT_BASE_URL

No

Override API base URL (default: https://api.fetchtranscript.com)

Development

cd mcp
pip install -e ".[dev]"
pytest tests/

Test with MCP Inspector:

FETCHTRANSCRIPT_API_KEY=yt_xxx mcp dev src/fetchtranscript_mcp/server.py

License

MIT

Available Tools

8 tools
get_channel_infoB

Get information about a YouTube channel.

Args: channel_id: YouTube channel ID (UCxxxxxx format) or handle (@username)

Inputs: channel_id (required). Returns: result

get_chaptersB

Get chapter list for a YouTube video.

Args: video_id: YouTube video ID (11 characters)

Inputs: video_id (required). Returns: result

get_commentsA

Get top comments on a YouTube video.

Args: video_id: YouTube video ID (11 characters) limit: Number of comments to fetch (default 20, max 500)

Inputs: video_id (required), limit. Returns: result

get_transcriptA

Get the transcript of a YouTube video.

Args: video_id: YouTube video ID (11 characters, e.g. 'dQw4w9WgXcQ') lang: Language code (e.g. 'en', 'it'). Auto-detected if omitted. format: Output format — 'text' (default), 'json' (segments with timestamps), or 'srt'.

Inputs: video_id (required), lang, format. Returns: result

get_video_metadataB

Get metadata for a YouTube video (title, description, views, likes, etc.).

Args: video_id: YouTube video ID (11 characters)

Inputs: video_id (required). Returns: result

list_channel_videosB

List videos from a YouTube channel.

Args: channel_id: YouTube channel ID (UCxxxxxx format) or handle (@username) limit: Number of videos to return (default 10, max 100) offset: Number of videos to skip for pagination (default 0) include_shorts: Whether to include YouTube Shorts (default false)

Inputs: channel_id (required), limit, offset, include_shorts. Returns: result

list_languagesB

List available transcript languages for a YouTube video.

Args: video_id: YouTube video ID (11 characters)

Inputs: video_id (required). Returns: result

search_videosC

Search YouTube videos.

Args: query: Search query string limit: Number of results (default 5, max 50)

Inputs: query (required), limit. Returns: result

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool targets a clearly distinct resource or action: transcript, comments, metadata, chapters, languages, channel info, channel video listing, and search. There is no meaningful overlap between any pair, and argument shapes reinforce the distinctions.

    Naming Consistency5/5

    All tool names use a consistent snake_case verb_noun pattern (get_, list_, search_) with predictable resource suffixes. The use of get_ vs list_ vs search_ is semantically coherent and easy to follow.

    Tool Count5/5

    Eight tools is well-scoped for a YouTube transcript and metadata server, with each tool earning its place. Nothing feels redundant or conspicuously absent from the count perspective.

    Completeness4/5

    The surface covers the core lifecycle well: transcript retrieval, language discovery, comments, metadata, chapters, channel info, channel videos, and search. Minor gaps exist—e.g., no comment-reply retrieval or in-transcript search—but agents can work around these for most transcript-focused workflows.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers