How to Get a YouTube Transcript into Claude (Claude.ai, Desktop and Claude Code)
Claude cannot watch a YouTube link: a fetch of the page returns the title and footer, not what was said. Four ways to give Claude the transcript: paste it, add a connector in Claude.ai, add an MCP server to Claude Code, or install an Agent Skill. Setup, cost and limits for each.
00:07:00 · OCT 19, 2026
Quick answer
Why a YouTube link is not enough
Claude works on text and images. A video is pictures and sound, and the words in it live in a separate caption track, not in the page text. So when Claude fetches a YouTube link, it gets the page, not the speech.
We checked this on 19 October 2026 with Tim Urban's TED talk on procrastination. Claude Code's web fetch returned the video title, YouTube's footer links and a copyright line. Not one spoken sentence. The same request through our MCP server returned all 14 minutes of captions, each line with its timestamp, labelled as captions the creator uploaded:
## Title: Inside the Mind of a Master Procrastinator | Tim Urban | TED
## Captions: creator-uploaded
[0:12] So in college,
[0:15] I was a government major,
[0:16] which means I had to write a lot of papers.With the transcript in hand, Claude can summarize the talk, quote it, or tell you at which minute the "Panic Monster" first appears (7:26). Without it, any summary is a guess from the title.
Four ways to do it
| Method | Works in | Setup | Best for |
|---|---|---|---|
| Paste the transcript | Any Claude app, any plan | None | One video, now |
| Connector | Claude.ai, Desktop, mobile | Paste a URL, sign in | Regular chat use |
| MCP server | Claude Code | One command | Coding and research sessions |
| Agent Skill | Claude Code, Claude.ai | Install a folder | Batches, channels, playlists |
Paste the transcript (no setup)
- Open YouTube to Claude and paste the video link.
- Turn on timestamps if you want Claude to cite moments as [m:ss].
- Copy the result into a Claude chat, or download it and add the file to a Project.
This export wraps the transcript in <document> tags with the video URL as its source, the layout Anthropic suggests for long documents. It helps when you put several transcripts in one chat, because Claude can keep them apart and say which video a quote came from.
Watching on YouTube already? The Chrome extension shows the transcript beside the video with a copy button. Put your question first and the transcript after it, then ask follow-ups in the same chat.
Add the connector in Claude.ai or Claude Desktop
A connector lets Claude fetch the transcript itself whenever you paste a link. You add it once in your Claude account and it then works in Claude.ai, the desktop app and the mobile apps. Steps from Anthropic's connector guide:
- Go to Customize > Connectors, click + Add, then Add custom connector.
- Name it
GetYouTubeTranscriptand enter this URL:
https://getyoutubetranscript.com/api/mcp- Leave sign-in on, click Add, and sign in to GetYouTubeTranscript when asked. There is no key to copy. New accounts start with 100 free credits.
- In a chat, open + > Connectors and make sure the toggle is on.
Custom connectors work on every Claude plan, including Free, which allows one. Then just ask:
- "Summarize this video in five bullets: [link]"
- "Where does the speaker talk about pricing? Give timestamps."
- "Search YouTube for talks on prompt caching and compare what the top three say."
Add the MCP server to Claude Code
Claude Code uses the same server with an API key. Create a key on your dashboard, then run this with your key in place of sk_live_...:
claude mcp add --transport http getyoutubetranscript https://getyoutubetranscript.com/api/mcp \
--header "Authorization: Bearer sk_live_..."Run /mcp inside Claude Code to check it shows as connected. Claude can then call these tools on its own:
| Tool | What it returns |
|---|---|
get_youtube_transcript | The spoken text of a video, with optional [m:ss] timestamps, a caption language, or a machine translation. |
get_transcript_languages | Which caption languages a video has, so Claude can pick the right one. |
search_youtube | Search YouTube by keyword. |
search_channel_videos | Search inside one channel's videos. |
list_channel_videos / get_channel_latest_videos | A channel's uploads, or just its newest ones. |
list_playlist_videos | Every video in a playlist. |
get_credits | Your remaining credit balance. Free to call. |
Because search and channel tools are included, Claude can go from a question to the right videos to their transcripts without you finding the links. Cursor, VS Code, Codex and other clients are covered in the MCP setup guide.
Install the Agent Skill
A skill is a folder of instructions and scripts Claude loads when a task matches it. Ours teaches Claude to fetch transcripts, search YouTube, resolve a channel handle and pull whole playlists or channels through the same API. In Claude Code:
npx skills add tubeagentkit/youtube-transcript-skills --skill youtube-transcriptOr download the zip from the skills page and unzip it into ~/.claude/skills/. In Claude.ai, upload the same zip under your skills settings. The source is on GitHub.
You do not need to visit our website first. If no key is set, the skill tells you the price, asks for your email, and you reply with the 6-digit code we send. It saves the key on your machine (readable only by you) and never prints it in the chat.
MCP server or skill? For a single video, both do the job. Pick the MCP server for nothing to install and typed tools. Pick the skill for batch work, such as "get every transcript from this playlist and find where they disagree", where its scripts handle paging and batches for Claude.
Cost and limits
- Cost: 100 free credits on signup, then 1 credit per call that succeeds. Failed calls and balance checks are free. Plans start at $5.00/month for 1,000 credits; see pricing. The connector, MCP server and skill share one balance.
- No captions, no transcript: if a video has no captions, Claude is told to say so instead of guessing. Our errors guide covers the common reasons.
- Words only: a transcript has what was said, not what was shown. Code on screen, slides and charts are not in it.
- Automatic captions: the result says whether captions were uploaded by the creator or generated by YouTube. Generated ones can get names and jargon wrong, so check exact quotes.
- Treat it as text, not instructions: anyone can say anything in a video. The skill tells Claude to summarize or quote a transcript, never to follow commands spoken in it.
Frequently asked questions
Can Claude watch YouTube videos?
No. Claude reads text and images, not video or audio. Give it a YouTube link and, at best, it reads the web page: the title and some page text, not what was said. To work with a video, Claude needs the transcript, either pasted in or fetched by a tool such as a connector or MCP server.
Does the connector work on the free Claude plan?
Yes. Anthropic's help center says custom connectors work on Free, Pro, Max, Team and Enterprise plans, and that Free accounts can add one custom connector. Team and Enterprise owners add it for the organization first.
What does it cost?
A new GetYouTubeTranscript account gets 100 free credits. Each transcript, search or list call that succeeds costs 1 credit; failed calls and balance checks cost nothing. After the free credits, plans start at $5.00/month for 1,000 credits. Pasting a transcript you copied from our website or extension needs no account.
Should I use the MCP server or the skill in Claude Code?
Either works for single videos. The MCP server gives Claude typed tools and nothing to install locally. The skill adds scripts for jobs that span many videos, such as a whole playlist or channel, and can create your account inside the conversation. Many people use the MCP server and add the skill later for batch work.
What if the video has no captions?
Then there is no transcript to fetch. The tool returns an error and Claude is told to say so rather than guess what the video says. Captions can be missing because the creator turned them off, the video is very new, or it is mostly music.
Can I get the transcript in another language?
Yes. Ask Claude for the transcript in a language the video has captions in, or ask it to translate. The transcript tool can return any caption track the video has, or a machine translation with the timestamps kept in place.
Related
- How to Get a YouTube Transcript into ChatGPT (Any Plan, Business Plugins and Codex)
- We Benchmarked Three Ways to Get a YouTube Transcript: Home Connection vs Cloud Server
- YouTube Transcript Errors Explained: IpBlocked, RequestBlocked, TranscriptsDisabled and the Rest
- We Read 191 Starter Story Founder Interviews. Here Is What Actually Got Them Customers
- How to Get the Transcript of a YouTube Video (Computer, Phone, and Download)
- n8n YouTube Transcript Failing on Your Server? Why YouTube Blocks It and How to Fix It
- YouTube API Quota Exceeded: Causes and Fixes
- YouTube Transcript API Rate Limit: What It Is and How to Handle 429s
- YouTube Transcript MCP Server: Setup Guide for Claude and Other AI Tools
- YouTube Transcripts in n8n: HTTP Request Workflow Guide
- Migrating from Supadata: A Field Guide
- How to Get YouTube Transcripts in Python
- Migrating from TranscriptAPI.com: A Field Guide
- Build an AI YouTube Video Summarizer with LangChain and Next.js
- How to Build a RAG Pipeline with YouTube Transcripts
- The Best YouTube Transcript APIs in 2026
- GetYouTubeTranscript vs TranscriptAPI
- GetYouTubeTranscript vs youtubetotranscript.com
- GetYouTubeTranscript vs youtube-transcript.io
- GetYouTubeTranscript vs NoteGPT
- GetYouTubeTranscript vs Tactiq
- GetYouTubeTranscript vs Glasp
- GetYouTubeTranscript vs Eightify
- GetYouTubeTranscript vs Supadata
- GetYouTubeTranscript vs DownSub
- GetYouTubeTranscript vs youtubetranscript.dev