youtube-transcripts

What it does Gives any MCP-compatible agent (Claude, Cursor, VS Code, ChatGPT, Codex) clean YouTube transcripts as timestamped markdown, ready to use as…

От сообществаРаботаетНужен API-ключГлобальныйБесплатноТолько чтение

Что умеет

  • Get Transcript: Get the full transcript of a single YouTube video as timestamped markdown. Read-only: fetches existing captions, modifies nothing. Requires an API key; each successful call charges 1 c
  • Polish Transcript: Get a cleaned-up transcript of a YouTube video's auto-generated captions: punctuation and capitalisation restored, filler and false starts removed, paragraphs added, misheard names
  • Get Channel Transcripts: Get transcripts for a YouTube channel's most recent videos (newest first) as timestamped markdown, one section per video. Use for research across a creator's recent output; fo

Какие данные видит

Нужен ли аккаунт

Нужен API-ключ из настроек сервиса

What it does

Gives any MCP-compatible agent (Claude, Cursor, VS Code, ChatGPT, Codex) clean YouTube transcripts as timestamped markdown, ready to use as context. No scraping, no proxies, no YouTube rate limits to manage: the server handles the fetch and caches every result.

Tools

Tool What it does Cost
get_transcript Full transcript of one video (ID or URL) 1 credit
get_channel_transcripts Recent videos from a channel, newest first (limit 1-50) 1 credit per video
get_playlist_transcripts Videos from a playlist, in order (limit 1-50) 1 credit per video
polish_transcript Cleaned auto-captions: punctuation restored, filler removed, faithful to what was said ~3 credits per 1,000 words (min 5)

All tools are read-only. Videos without captions fail free. Rate limit: 5 requests per 10 seconds.

Setup

Get a free API key (25 free credits, no card) at youtubetranscriptdownload.com/account, then add the server:

{
  "mcpServers": {
    "ytd": {
      "url": "https://youtubetranscriptdownload.com/api/mcp",
      "headers": { "Authorization": "Bearer ytd_sk_YOUR_KEY" }
    }
  }
}

Claude Code:

claude mcp add --transport http \
  --header "Authorization: Bearer ytd_sk_YOUR_KEY" \
  ytd https://youtubetranscriptdownload.com/api/mcp

Example output

get_transcript returns the video title, source link, timestamped text, and a credit footer:

How Transformers Work

Source: https://youtube.com/watch?v=...

[00:00:12] The transformer architecture was introduced in the 2017 paper
Attention Is All You Need by Vaswani et al.
...

---
1 credit used · 42 remaining

get_channel_transcripts and get_playlist_transcripts return one section per video, separated by dividers; videos without captions are noted and cost nothing:

Lex Fridman Podcast · 3 videos

[transcript of video 1]

---

[transcript of video 2]

---

abc123xyz: No transcript available (skipped, not charged)

---
2 credits used · 40 remaining

polish_transcript turns raw auto-captions into clean text, faithful to what was said:

Before: so um the transformer architecture was introduced uh in the
attention is all you need paper in in 2017

After:  The transformer architecture was introduced in the Attention
Is All You Need paper in 2017.

Links

Как подключить

Как подключить youtube-transcripts к Claude

Адрес сервера, который нужно вставить в настройках Claude:

https://youtube-transcripts--hello-ympt.run.tools

  1. Откройте Claude (сайт claude.ai или приложение для компьютера).
  2. Перейдите в Настройки → Коннекторы (в английском интерфейсе: Settings → Connectors).
  3. Нажмите Добавить пользовательский коннектор (Add custom connector).
  4. Вставьте адрес сервера, скопированный ниже, в поле URL удалённого MCP-сервера и нажмите Добавить.
  5. В чате нажмите + → Коннекторы и включите новый коннектор.

Пользовательские коннекторы доступны на тарифах Free, Pro, Max, Team и Enterprise. На Free можно добавить только один. В Team и Enterprise коннектор сначала добавляет владелец организации в Настройки организации → Коннекторы.

Авторизация

После нажатия Добавить откроется окно входа в сервис. Войдите под своим аккаунтом и подтвердите доступ. Пароль Claude не видит.

Как подключить youtube-transcripts к ChatGPT

Адрес сервера, который нужно вставить в настройках ChatGPT:

https://youtube-transcripts--hello-ympt.run.tools

  1. Откройте ChatGPT в браузере (chatgpt.com). Нужен тариф Plus, Pro, Business, Enterprise или Edu.
  2. Один раз включите режим разработчика: Настройки → Приложения → Дополнительные настройки → Режим разработчика (Settings → Apps → Advanced settings → Developer mode).
  3. Откройте Настройки → Коннекторы и нажмите Создать (Create).
  4. Заполните форму: Название (любое), Описание (одна фраза, что делает сервис), URL MCP-сервера (скопируйте ниже).
  5. В поле Аутентификация выберите OAuth, если сервис требует вход, иначе Нет. Нажмите Создать.
  6. В новом чате откройте + → Приложения/Коннекторы и включите коннектор.

Название раздела у OpenAI менялось (Connectors → Apps/Plugins). Если пункт называется иначе, ищите «режим разработчика» в настройках. В рабочих пространствах Business/Enterprise администратор должен разрешить пользовательские коннекторы.

Авторизация

При первом использовании ChatGPT откроет окно входа в сервис. Войдите и подтвердите доступ.

Как подключить youtube-transcripts к Cursor

Адрес сервера, который нужно вставить в настройках Cursor:

https://youtube-transcripts--hello-ympt.run.tools

Быстрый способ: нажмите кнопку Открыть в Cursor ниже, Cursor сам предложит добавить сервер.

Вручную:

  1. В Cursor откройте Settings → Cursor Settings → MCP и нажмите Add new global MCP server.
  2. Вставьте JSON, скопированный ниже, в открывшийся файл ~/.cursor/mcp.json (для одного проекта: .cursor/mcp.json в корне проекта).
  3. Сохраните файл. Сервер появится в списке MCP; при необходимости пройдите авторизацию по кнопке рядом с ним.

Авторизация

Если сервис требует вход, рядом с сервером в списке MCP появится кнопка авторизации.

Список инструментов сервера (4)

Технические названия из tools/list. Нужны только разработчикам.

get_transcriptGet the full transcript of a single YouTube video as timestamped markdown. Read-only: fetches existing captions, modifies nothing. Requires an API key; each successful call charges 1 credit, including repeat calls for the same video, so reuse a transcript already in context instead of re-fetching. Videos without captions return an error and cost nothing. Rate limit: 5 requests per 10 seconds.
polish_transcriptGet a cleaned-up transcript of a YouTube video's auto-generated captions: punctuation and capitalisation restored, filler and false starts removed, paragraphs added, misheard names fixed, faithful to what was said. Use when raw captions are too messy to read or quote; for a plain transcript use get_transcript. Read-only; requires an API key. Each call charges credits by transcript length (about 3 per 1,000 words, minimum 5), including repeat calls, so keep the result in context. Human-uploaded captions (already clean) and transcripts over ~7,000 words return an error without charging. Rate limit: 5 requests per 10 seconds.
get_channel_transcriptsGet transcripts for a YouTube channel's most recent videos (newest first) as timestamped markdown, one section per video. Use for research across a creator's recent output; for one known video use get_transcript. Read-only; requires an API key. Charges 1 credit per video that returns a transcript, including repeat calls; videos without captions are skipped free. A 10-video call typically costs up to 10 credits, so start with a small limit. Rate limit: 5 requests per 10 seconds.
get_playlist_transcriptsGet transcripts for the videos in a YouTube playlist (in playlist order) as timestamped markdown, one section per video. Use for working through a course, series, or curated list; for one known video use get_transcript. Read-only; requires an API key. Charges 1 credit per video that returns a transcript, including repeat calls; videos without captions are skipped free. A 10-video call typically costs up to 10 credits, so start with a small limit. Rate limit: 5 requests per 10 seconds.