[Integrations](https://spiral.ai/integrations) › [Notion](https://spiral.ai/integrations/notion) › [YouTube video transcript](https://spiral.ai/integrations/notion/youtube-video-transcript)

# How to Use YouTube video transcript in Notion

Fetch a video's spoken content from its available YouTube captions. Use it to summarize a talk, find a passage, or compare explanations without relying on the video's title and description.

|  |  |
| --- | --- |
| Model | YouTube video transcript |
| Available through | Alexandria |
| Category | Social Media |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with YouTube video transcript in Notion

- Each Monday, use YouTube video transcript for https://www.youtube.com/watch?v=iG9CE55wbtY. Compare the caption text with the previous retrieval and report only changes that affect the main argument or examples.
- Every day for the next week, use YouTube video transcript for https://www.youtube.com/watch?v=8mAITcNt710 until captions are available. Then give me a concept outline and stop checking.
- Once a month, use YouTube video transcript for https://www.youtube.com/watch?v=qp0HIF3SfI4. Check whether the passages supporting my previous summary have changed and explain any effect on that summary.
- Each Friday, use YouTube video transcript for https://www.youtube.com/watch?v=rfscVS0vtbw. Compare its spoken instructions with the previous retrieval and flag changed instructions for review.
- Once a month, use YouTube video transcript for https://www.youtube.com/watch?v=D9Ihs241zeg. Compare it with the previous retrieval and report revised passages about stereotypes; report unavailable captions separately.

## How to set up YouTube video transcript in Notion

Pick the way that suits you. Each takes about two minutes.

### Use the Spiral skill

1. **Send Notion this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use Spiral's MCP server

1. **Allow custom MCP servers**: A workspace owner opens Settings › Connections, then the Manage tab, and turns on Enable custom MCP servers. Where members may install only approved connections, also add Spiral under Approved connections › Add approved connection › Custom MCP server with the URL below.

2. **Add Spiral to a custom agent**: Open the custom agent (or create one), then Settings › Tools & Access › Add connection › Custom MCP server. Paste this URL, name it Spiral, keep OAuth and click Connect.

```text
https://api.spiral.ai/mcp
```

3. **Sign in to Spiral and approve**: Spiral opens: sign in, pick the organization and click Authorize. No API key. Spiral gives the connection its own key; Notion never sees it, and you can remove it under Settings › Connected apps in the console.

4. **Run YouTube video transcript in a workflow step**: Give the step an instruction like the ones below and run it on your trigger or schedule. Spiral finds YouTube video transcript, prices it and runs it each time the step fires.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run YouTube video transcript**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "youtube-com/videos/video_transcript",
    "input": {
      "video_id": "<video_id>"
    }
  }'
```

Then paste one of the prompts above: Notion finds YouTube video transcript on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/notion

## YouTube video transcript tools and prices

- [YouTube · Video transcript](https://spiral.ai/tools/alexandria/youtube-com/videos/video_transcript) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| url |  | — | A youtube.com watch, shorts, live, embed or youtu.be URL; the video id is taken from it. |
| language |  | — | Caption language code to fetch (en, de-DE, es-419). Default: the first manual track, else the first auto-generated one. Pattern: ^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})*$. |
| video_id |  | — | YouTube video id, 11 URL-safe characters. Pattern: ^[A-Za-z0-9_-]{11}$. |
| translate_to |  | — | Language code to translate the track into server-side; must be one the source lists as a translation target. Pattern: ^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})*$. |

## What can you do with YouTube video transcript in Notion?

Keep a brief for a selected public YouTube video aligned with changes to its captions. A scheduled agent can retry while captions are unavailable and compare later text with an earlier retrieval.

### Brief a long talk

Turn a captioned public talk into a concise brief covering its main argument, examples, and conclusions, with links back to the video.

### Find passages for audio review

Search caption text for a topic or phrase and collect candidate passages to verify against the speaker's audio before quoting.

### Compare public explanations

Compare how two educational videos explain the same concept. Identify shared points, different examples, and claims that need further checking.

### Create study questions

Build a glossary, review questions, and an answer key from a captioned lecture, keeping each answer tied to the lecture's wording.

### Check documentation against a tutorial

Compare a public software tutorial's spoken instructions with project documentation and flag differences for a developer to investigate.

### Review caption revisions

Compare caption text from repeated retrievals of a selected public video and report changes to wording that affect an existing summary.

### Prepare discussion notes

Extract a talk's central claims and supporting examples, then draft discussion questions that distinguish the speaker's statements from your analysis.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Notion guides](https://spiral.ai/integrations/notion)

## YouTube video transcript in other agents

- [Amp](https://spiral.ai/integrations/amp/youtube-video-transcript)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/youtube-video-transcript)
- [Claude](https://spiral.ai/integrations/claude-desktop/youtube-video-transcript)
- [Claude Code](https://spiral.ai/integrations/claude-code/youtube-video-transcript)
- [Cline](https://spiral.ai/integrations/cline/youtube-video-transcript)
- [Codex](https://spiral.ai/integrations/codex/youtube-video-transcript)
- [Cursor](https://spiral.ai/integrations/cursor/youtube-video-transcript)
- [Devin](https://spiral.ai/integrations/devin/youtube-video-transcript)
- [dots](https://spiral.ai/integrations/dots/youtube-video-transcript)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/youtube-video-transcript)
- [Gemini](https://spiral.ai/integrations/gemini/youtube-video-transcript)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/youtube-video-transcript)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/youtube-video-transcript)
- [goose](https://spiral.ai/integrations/goose/youtube-video-transcript)
- [Grok](https://spiral.ai/integrations/grok/youtube-video-transcript)
- [Grok Build](https://spiral.ai/integrations/grok-build/youtube-video-transcript)
- [Hermes](https://spiral.ai/integrations/hermes/youtube-video-transcript)
- [Instinct](https://spiral.ai/integrations/instinct/youtube-video-transcript)
- [Manus](https://spiral.ai/integrations/manus/youtube-video-transcript)
- [Muse](https://spiral.ai/integrations/muse/youtube-video-transcript)
- [Muse Code](https://spiral.ai/integrations/muse-code/youtube-video-transcript)
- [n8n](https://spiral.ai/integrations/n8n/youtube-video-transcript)
- [OpenClaw](https://spiral.ai/integrations/openclaw/youtube-video-transcript)
- [opencode](https://spiral.ai/integrations/opencode/youtube-video-transcript)
- [Perplexity](https://spiral.ai/integrations/perplexity/youtube-video-transcript)
- [Raycast](https://spiral.ai/integrations/raycast/youtube-video-transcript)
- [VS Code](https://spiral.ai/integrations/vscode/youtube-video-transcript)
- [Windsurf](https://spiral.ai/integrations/windsurf/youtube-video-transcript)
- [Zapier](https://spiral.ai/integrations/zapier/youtube-video-transcript)

## More Notion guides

- [YouTube video sponsor detection](https://spiral.ai/integrations/notion/youtube-video-sponsor-detection)
- [Spiral media tools](https://spiral.ai/integrations/notion/spiral)
- [YouTube video search](https://spiral.ai/integrations/notion/youtube-video-search)
- [Baseball Savant MLB daily schedule](https://spiral.ai/integrations/notion/baseball-savant-mlb-daily-schedule)
- [YouTube video playback links](https://spiral.ai/integrations/notion/youtube-video-playback-links)
- [Baseball Savant leaderboards](https://spiral.ai/integrations/notion/baseball-savant-leaderboards)

## Questions about YouTube video transcript in Notion

**Can Notion use YouTube video transcript?**

Yes. Add Spiral to Notion as an MCP server, and Notion can find and run YouTube video transcript like any built-in tool.

**How much does YouTube video transcript cost in Notion?**

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Notion plan is separate.

**Do I need an Alexandria account to use YouTube video transcript in Notion?**

No. Spiral runs YouTube video transcript on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up YouTube video transcript in Notion?**

About two minutes: allow custom MCP servers, then add Spiral to a custom agent, then sign in to Spiral and approve.

**Does Notion wait while YouTube video transcript runs?**

YouTube video transcript runs in the background. Notion starts the run, checks on it and gives you the json when it's ready.

**Does every YouTube video have a transcript?**

No. YouTube makes its full transcript available for videos that have captions, so a watchable video does not by itself establish transcript availability.

**Are automatic captions available as soon as a video is uploaded?**

Not always. YouTube says automatic captions may not be ready at upload, and processing time depends on the complexity of the video's audio.

**How accurate are YouTube's automatic captions?**

YouTube warns that mispronunciations, accents, dialects, and background noise can cause captions to misrepresent speech. Check the audio before treating a caption passage as an exact quotation.

**Does YouTube automatically caption a video in every language?**

No. YouTube says automatic captions are in the video's default language only; do not assume a separate caption track exists for every language.

**Can a video's transcript change after publication?**

Yes. Creators can edit caption text and timestamps or delete captions completely, so the same video can later have revised text or lose its captions.

