Skip to main content

MCP server that fetches YouTube video transcripts and optionally summarizes them

Project description

youtube-summarize

MCP server that fetches YouTube video transcripts and optionally summarizes them.

Demo — summarizing a YouTube video in Claude

Features

  • Fetch transcripts in multiple formats (text, JSON, SRT, WebVTT, pretty-print)
  • Summarize videos — returns transcript with instructions for the LLM to produce a summary
  • List available languages for any video's transcripts
  • Flexible URL parsing — accepts full YouTube URLs (youtube.com/watch?v=, youtu.be/, youtube.com/embed/, youtube.com/shorts/) or bare video IDs
  • Multi-language support — request transcripts in specific languages with fallback priority

Tools

get_transcript

Fetch a YouTube video's transcript.

Parameter Type Default Description
url string required YouTube video URL or video ID
languages string[] ["en"] Preferred languages in priority order
format string "text" Output format: text, json, pretty, webvtt, srt
preserve_formatting boolean false Keep HTML formatting tags in the transcript

summarize_transcript

Fetch a transcript and return it with summarization instructions for the LLM client.

Parameter Type Default Description
url string required YouTube video URL or video ID
prompt string (default prompt) Custom summarization instructions
languages string[] ["en"] Preferred languages in priority order

list_transcripts

List available transcript languages for a video.

Parameter Type Default Description
url string required YouTube video URL or video ID

Installation

Quick start (recommended)

uvx youtube-summarize

Claude Desktop

Add to your claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "youtube-summarize": {
      "command": "uvx",
      "args": ["youtube-summarize"]
    }
  }
}

Claude Code

claude mcp add youtube-summarize -- uvx youtube-summarize

Other MCP clients

Run the server over stdio:

uvx youtube-summarize

Prerequisites

  • Python 3.13+
  • uv package manager

Development

# Install dependencies
uv sync

# Launch the MCP inspector (web UI for testing tools)
uv run mcp dev main.py

License

MIT


mcp-name: io.github.zlatkoc/youtube-summarize

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

youtube_summarize-0.2.3.tar.gz (4.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

youtube_summarize-0.2.3-py3-none-any.whl (5.8 kB view details)

Uploaded Python 3

File details

Details for the file youtube_summarize-0.2.3.tar.gz.

File metadata

  • Download URL: youtube_summarize-0.2.3.tar.gz
  • Upload date:
  • Size: 4.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for youtube_summarize-0.2.3.tar.gz
Algorithm Hash digest
SHA256 b3fe3bfbb910d01dcd0f740df54a03a4d27aab6b69b551e133c16ede62d8f346
MD5 159339080e7b9fb3ab8d3702f60fdc85
BLAKE2b-256 d3fb0bea17fde4a7884d4818deb94eaf19f79f3d9e9cd3adf0997e8dcfa55e04

See more details on using hashes here.

Provenance

The following attestation bundles were made for youtube_summarize-0.2.3.tar.gz:

Publisher: publish.yml on zlatkoc/youtube-summarize

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file youtube_summarize-0.2.3-py3-none-any.whl.

File metadata

File hashes

Hashes for youtube_summarize-0.2.3-py3-none-any.whl
Algorithm Hash digest
SHA256 1472fe56c90c4c6c8aa173b74e6daac00d3b3855a475d108ac621f2af08489bc
MD5 45966c0a27c3582351cbdfc334476425
BLAKE2b-256 311a4e44ba6eb811f20c59d2c4a94f79606f7477bc4ef9b27184ea7f528e8db9

See more details on using hashes here.

Provenance

The following attestation bundles were made for youtube_summarize-0.2.3-py3-none-any.whl:

Publisher: publish.yml on zlatkoc/youtube-summarize

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page