YouTube Transcript AI
Fetch the full transcript of any YouTube video as text, in any caption language. Free API key.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http youtube-transcript-ai 'https://youtube-transcript.ai/mcp' --header 'Authorization: <API key sent as a Bearer token. Create a free key at https://youtube-transcript.ai/get-api-key>'
{
"mcpServers": {
"youtube-transcript-ai": {
"type": "http",
"url": "https://youtube-transcript.ai/mcp",
"headers": {
"Authorization": "<API key sent as a Bearer token. Create a free key at https://youtube-transcript.ai/get-api-key>"
}
}
}
}
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
YouTube Transcript MCP Server
Give Claude, ChatGPT, Cursor, Claude Code and any MCP client the ability to read YouTube transcripts. Hosted, nothing to install. Free API key: 10 requests a day.
A hosted Model Context Protocol server that exposes one tool, get_youtube_transcript, backed by youtube-transcript.ai. Paste a YouTube link mid-conversation and your AI reads the full transcript on demand.
Connector URL:
https://youtube-transcript.ai/mcp?key=YOUR_KEY
Replace YOUR_KEY with your API key. Create a free key with a Google sign-in; it takes about a minute.
Why
- Free to start. A free key covers 10 transcripts a day. Pro is 1,000 a day for $120 a year, on the same key.
- Reliable. A hardened fetch pipeline with proxy fallback returns transcripts even on videos that block typical scrapers.
- Any language. Pick a caption track by language code (
en,zh-CN,es,ja, …) or let it choose the default. - Built for agents. One tool, plain-text output with title and metadata. Multi-hour videos come back in parts, so nothing gets cut off.
Authentication
Tool calls need an API key. There is no OAuth. Send the key in one of two ways:
| Where | Example |
|---|---|
| Header | Authorization: Bearer YOUR_KEY |
| URL | https://youtube-transcript.ai/mcp?key=YOUR_KEY |
The URL form is for clients that only accept a connector URL.
Quick start
Claude (web / desktop)
Settings → Connectors → Add custom connector
| Field | Value |
|---|---|
| Name | youtube-transcript.ai |
| URL | https://youtube-transcript.ai/mcp?key=YOUR_KEY |
Then ask: *“Summarize this video: https://youtu.be/dQw4w9WgXcQ”*
ChatGPT
In the custom connector / MCP server setup, add an MCP server with URL https://youtube-transcript.ai/mcp?key=YOUR_KEY (transport: Streamable HTTP), enable it for your chat, then paste a YouTube link.
Claude Code
claude mcp add --transport http --scope user youtube-transcript \
https://youtube-transcript.ai/mcp \
--header "Authorization: Bearer YOUR_KEY"
Cursor
Add to ~/.cursor/mcp.json, or to .cursor/mcp.json inside one project:
{
"mcpServers": {
"youtube-transcript": {
"url": "https://youtube-transcript.ai/mcp",
"headers": { "Authorization": "Bearer YOUR_KEY" }
}
}
}
Codex
Add to ~/.codex/config.toml:
[mcp_servers.youtube-transcript]
url = "https://youtube-transcript.ai/mcp"
http_headers = { "Authorization" = "Bearer YOUR_KEY" }
Clients that only launch local servers
For clients that start MCP servers from a config file and cannot take a remote URL, bridge with mcp-remote:
{
"mcpServers": {
"youtube-transcript": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://youtube-transcript.ai/mcp?key=YOUR_KEY"]
}
}
}
Let your agent do it
Paste https://youtube-transcript.ai/mcp.md into a coding agent. It is a plain-text version of these instructions, written for an AI to follow.
Tool reference
get_youtube_transcript
Fetch the full text transcript of a YouTube video.
| Parameter | Type | Required | Description |
|---|---|---|---|
video | string | yes | YouTube URL (watch, youtu.be, shorts, embed) or a bare 11-character video ID |
lang | string | no | Caption language code, e.g. en, zh-CN, es. Omit for the default track |
offset | integer | no | Where to continue a long transcript. Use the value given at the end of the previous part |
Returns plain text: the transcript with title, duration, and a list of available languages. Transcripts over 120,000 characters come back in parts; each part ends with a note giving the offset for the next call.
Example prompts
- “Summarize the key points of
<link>in 5 bullets.” - “Pull the transcript of this video and translate it to Spanish.”
- “What does the speaker say about pricing in
<link>? Quote the exact lines.”
Programmatic use
The server speaks standard MCP over Streamable HTTP (JSON-RPC). A zero-dependency example is in examples/quickstart.mjs:
YT_TRANSCRIPT_KEY=YOUR_KEY node examples/quickstart.mjs https://youtu.be/dQw4w9WgXcQ
Calling from your own code without MCP? There is a plain HTTP endpoint too: see the YouTube Transcript API.
Limits
- Free: 10 requests a day. Pro: 1,000 a day for $120 a year. Upgrade from the key page.
- Every tool call counts as one request, including each part of a long transcript. The count resets at 00:00 UTC.
- The video needs captions, either written by the uploader or auto-generated by YouTube.
Notes
- Not affiliated with YouTube or Google. Transcripts are fetched from publicly available captions.
- Listed in the official MCP Registry as
ai.youtube-transcript/youtube-transcript.
Links
- Web tool (no AI client needed): https://youtube-transcript.ai
- Connector landing page: https://youtube-transcript.ai/mcp
- HTTP API: https://youtube-transcript.ai/api
License
MIT
Frequently asked questions
What is YouTube Transcript AI?
Fetch the full transcript of any YouTube video as text, in any caption language. Free API key.
How do I install YouTube Transcript AI?
It runs as a remote server. In Claude Code: claude mcp add --transport http youtube-transcript-ai 'https://youtube-transcript.ai/mcp' --header 'Authorization: <API key sent as a Bearer token. Create a free key at https://youtube-transcript.ai/get-api-key>'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does YouTube Transcript AI need an API key?
Yes. It expects Authorization, which you set in its configuration.
Is YouTube Transcript AI open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains YouTube Transcript AI?
It is published by zxl777. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.