This repo root is also an Agent Plugins 1.0.0 package. It bundles the MCP server with a youtube skill that tells the agent which tool to use when, what each one costs, and how to avoid wasting credits.
plugin.json # plugin manifest
mcp.json # hosted MCP server (streamable-http, OAuth, no key in the file)
skills/youtube/SKILL.md # when and how to use the 8 tools
In VS Code, run Chat: Install Plugin From Source and paste https://github.com/tubeagentkit/youtube-mcp. Other clients that support Agent Plugins can point at this repo or a local clone. For Cursor there is a separate plugin repo.
The package holds no credentials. Check the manifests against the published schemas yourself:
The same plugin.json carries the ChatGPT/Codex plugin directory listing under extensions.com.openai (other clients ignore it). scripts/build-openai-zip.sh checks it against OpenAI's field limits and builds the upload ZIP in dist/, with only plugin.json, mcp.json, skills/ and assets/.
Tip: clients that support MCP OAuth can skip the headers block in the snippets below and sign in through the browser instead.
Tip: to stop repeating "use the transcript tool", add a standing instruction to your client's rules or custom instructions, for example: "When I share a YouTube link, fetch its transcript with the youtube-transcript MCP before answering."
Summarize this video for me: https://youtu.be/dQw4w9WgXcQ
The agent calls get_youtube_transcript and summarizes the result. If you connected via OAuth, there's no key to configure at all — just approve the connection once.
Run locally (stdio)
Prefer a local process? server/ is an open-source stdio MCP server with the same 8 tools, built on the official MCP TypeScript SDK. It calls the public REST API with your API key.
No manual key management — sign in via browser, the server handles the rest.
Dynamic Client Registration (DCR): supported for clients that self-register at connect time (Claude Desktop/Web, ChatGPT, and most others).
Client ID Metadata Documents (CIMD): supported per the current MCP spec (2026-07-28) for clients that host their own metadata document — the more modern alternative to DCR, no shared secret required.
First connection opens a consent screen showing exactly what access is being granted; approve once and you're connected.
Both methods issue a token scoped and audience-bound to this specific MCP server — it can't be replayed against any other API.
Available Tools
All eight tools are exposed automatically once you connect. 1 credit = 1 successful request. Failed or rate-limited calls never consume credits.
1. get_youtube_transcript
Fetch the full transcript for a YouTube video, plus its title/author/thumbnail metadata.
Parameter
Type
Required
Description
video_url
string
required
YouTube URL (full or short) or an 11-character video ID
language
string
optional
Language code, e.g. en, es. Defaults to en
send_metadata
boolean
optional
Include title/author/thumbnail. Defaults to true
timestamps
boolean
optional
One line per caption, each starting with its [m:ss] start time ([h:mm:ss] past an hour). Defaults to false (one block of text)
Cost: 1 credit, with or without timestamps.
2. get_transcript_languages
List the caption languages a video offers, creator-uploaded or auto-generated, and which one a default request returns.
Parameter
Type
Required
Description
video_url
string
required
YouTube URL (full or short) or an 11-character video ID
An empty list means the video has captions turned off. Not needed for an ordinary transcript request: get_youtube_transcript already reports the language it returned.
Cost: 1 credit.
3. search_youtube
Search YouTube for videos or channels, paginated.
Parameter
Type
Required
Description
query
string
required unless continuation set
Search query
search_type
"video" | "channel"
optional
Defaults to "video"
continuation
string
optional
Opaque token from a previous response — fetches the next page
Cost: 1 credit/page.
4. get_channel_latest_videos
Get a channel's metadata plus its most recent uploads.
Parameter
Type
Required
Description
channel
string
required
@handle, channel URL, or UC… channel ID
Cost: 1 credit.
5. search_channel_videos
Search within one specific channel's videos.
Parameter
Type
Required
Description
channel
string
required unless continuation set
@handle, channel URL, or UC… ID
query
string
required unless continuation set
Query to search within the channel
continuation
string
optional
Opaque token — fetches the next page
Cost: 1 credit/page.
6. list_channel_videos
List every video a channel has ever uploaded (the full /videos tab, not just recent ones).
Parameter
Type
Required
Description
channel
string
required unless continuation set
@handle, channel URL, or UC… ID
continuation
string
optional
Opaque token — fetches the next page
Cost: 1 credit/page.
7. list_playlist_videos
Get every video in a YouTube playlist.
Parameter
Type
Required
Description
playlist
string
required unless continuation set
Playlist URL or ID
continuation
string
optional
Opaque token — fetches the next page
Cost: 1 credit/page.
8. get_credits · FREE
Check the remaining credit balance for your key/account. No parameters.
Cost: Free.
Use Cases & Prompts
Use Case
Example Prompt
📝 Summarize a video
"Summarize the key points from this video: [URL]"
🔍 Research a topic
"Search YouTube for the 5 most-watched videos on neural radiance fields; summarize each."
🧠 Study notes
"Create study notes from this MIT lecture series playlist: [PLAYLIST URL]"
📡 Monitor a creator
"Each morning, list new uploads from @hubermanlab and tell me which to watch."
🏛️ Build a content database
"Pull every video from @veritasium and store title + transcript."
🎯 Channel research
"Search inside @MKBHD for any video about [topic] and summarize the takeaways."
✍️ Repurpose content
"Turn this video into a 1,500-word blog post: [URL]"
If using an API key: confirm it starts with sk_live_ and has no extra whitespace
If using OAuth: try disconnecting and reconnecting the connector
Confirm the key/connection is still active in your dashboard
Check your balance and top up or upgrade at the dashboard.
The video may not have captions enabled
It may be private, age-restricted, or region-locked
Confirm it plays in a real browser first
Back off and retry after a short delay — don't hammer it in a tight loop.
Clear cookies for getyoutubetranscript.com and retry
Ensure popup/redirect blockers aren't interfering with the consent screen
If your client supports both DCR and CIMD, try the other registration method
Verification
This repo contains the MIT-licensed source of the local stdio MCP server in server/
(tool definitions, input validation, API calls, error mapping), plus the manifests for the
hosted endpoint. The hosted endpoint and the REST API behind both are run by
getyoutubetranscript.com and are not open source. To check either one yourself:
Run the local server's live test — GYT_API_KEY=sk_live_... npm test --prefix server
starts server/index.js over stdio, lists all 8 tools, and calls the free ones.
Run verify.js against the hosted endpoint — zero dependencies, zero auth required:
node verify.js
It performs the real MCP handshake (initialize then tools/list) against the live
endpoint and prints the server's actual response, including all 8 real tool schemas.
Tool discovery is public; only tool calls require an API key or OAuth token (see
Authentication).
Independently verified by four third-party MCP directories, each of which connected
to the live endpoint and confirmed the tools themselves (not just took our word for it):
Official MCP Registry — com.getyoutubetranscript/youtube-transcript-and-youtube-search, published via domain-ownership-verified HTTP mcp-publisher
Smithery — its own scanner connected and discovered all 6 tools
Live since 2026-09-12 — the OAuth 2.1 (DCR + CIMD) flow has also been exercised
end-to-end by a real third-party client (Smithery) connecting via CIMD, which surfaced
and got a real interop fix along the way (see commit history).
Also available as a REST API
Building an app instead of an agent? The same backend is a plain JSON REST API — see the Agent Skill repo for the full endpoint reference, or the dashboard to get a key directly.
Use this when the user shares a YouTube video link or ID, or asks to summarize, explain, quote, translate, take notes on, or chat about a specific YouTube video, lecture, podcast, or talk. Returns the full spoken text (captions) as one block, plus the title and channel. Set timestamps to true when t
Use this when the user asks which caption or subtitle languages a YouTube video has, or before requesting a transcript in a non-English language when you don't know whether the video offers it. Returns each language with its code (pass it as `language` to get_youtube_transcript), whether it is creat
FAQ
Fragen
Wie installiere ich YouTube Transcript + YouTube Search MCP?
Use this when the user wants to find YouTube videos or channels on a topic, for example 'find lectures on linear algebra' or 'popular videos about the Apollo missions', before reading or comparing them. Returns each result's title, video ID, link, channel, views, length, and upload date. Pass `conti
Use this when the user asks what a YouTube channel has posted recently, or wants a channel's details (name, handle, description, subscribers) with its 15 newest uploads. Accepts an @handle, channel URL, or UC... ID. For a channel's full upload history use list_channel_videos; to find a topic inside
Use this when the user wants videos from one specific YouTube channel about a topic, for example 'what has @hubermanlab said about sleep' or 'find the MIT OpenCourseWare videos on recursion'. Searches only inside that channel. Pass `continuation` from a previous response for the next page.
Use this when the user wants to browse a YouTube channel's uploads beyond its latest videos, for example to see a creator's older episodes or find a video they remember from that channel. Returns the channel's uploads (its Videos tab) one page at a time. Pass `continuation` from a previous response
Use this when the user shares a YouTube playlist, or wants to work through a course, lecture series, or podcast playlist video by video (for example to build study notes for each lecture). Returns the videos in playlist order, one page at a time. Pass `continuation` from a previous response for the
Use this when the user asks how many credits their getyoutubetranscript.com account has left, or after another tool reports the account has no credits remaining. Returns plan and top-up credit balances. Calling it does not use credits.
Kopieren Sie auf dieser Seite die http-Konfiguration für Cursor, Claude Desktop, Claude Code oder VS Code. Sie nutzt die Installation des Herausgebers, keinen PlugMCP-Proxy.
Benötigt YouTube Transcript + YouTube Search MCP einen API-Schlüssel?
In diesem Eintrag ist keine erforderliche Umgebungsvariable aufgeführt.
Welchen Transport verwendet YouTube Transcript + YouTube Search MCP?
YouTube Transcript + YouTube Search MCP wird über HTTP erreicht.
Wann wurde YouTube Transcript + YouTube Search MCP zuletzt geprüft?
Zuletzt geprüft: 2026-10-23. YouTube transcripts, search, channel browsing, and playlists for AI agents via MCP.