YouTube Transcript
Retrieve and store captions for one video or a bounded batch, read job and batch status, access stored transcripts and languages, and resolve playlist or channel video metadata through the YouTube Transcript REST API.
Verdict
Common use cases
- Summarize conference keynotes for team updates
- Extract action items from recorded client calls
- Compare competitor product demos side by side
- Search tutorial libraries for specific topics
- Audit webinar content for compliance keywords
Integration
- Vendor
- YouTube Transcript
- Category
- other
- Auth
- API_KEY
- Tools
- 9
- Composio slug
youtube_transcript
Tools
- Get Stored Transcript
Read a transcript already stored in the connected account without submitting new transcription work or consuming retrieval credits.
- Get Video Transcript
Fetch captions for one YouTube video and store the resulting transcript in the connected account. This consumes provider credits, but never starts ASR. The tool waits up to 20 seconds for asynchronous caption jobs; if one is still processin
- Get Video Transcript Job Status
Read one transcript job's current processing, completed, failed, or requires-ASR-confirmation state without creating work or waiting. Use this one-shot read when GET_VIDEO_TRANSCRIPT times out, passing the same include flags to recover the
- Get Video Transcripts Batch
Fetch and store captions for 1-10 YouTube videos. Each uncached video can consume provider credits, so cost scales with the request size. ASR never starts. This creates one batch and waits up to 20 seconds for a terminal result; if it is st
- Get Video Transcripts Batch Status
Read the current state and available per-video results for a transcript batch without creating work or waiting. Use this one-shot read to recover when GET_VIDEO_TRANSCRIPTS_BATCH times out while the provider is still processing.
- List Stored Transcripts
List and search transcripts already stored in the connected account, one bounded page at a time.
- List Transcript Languages
List stored languages and YouTube translation target languages for one owned video transcript.
- Resolve Channel Videos
Requires Basic or higher. Resolve a YouTube channel into bounded upload metadata without transcribing the videos. This may count against the account's monthly channel allowance.
- Resolve Playlist Videos
Requires Basic or higher. Resolve a YouTube playlist into bounded video metadata without transcribing the videos. This may count against the account's monthly playlist allowance.
Setup
Setup guide
- 11. Open your Switchy workspace and navigate to Settings → Integrations → Browse MCP Servers. 2. Search for YouTube Transcript and click Connect. 3. The setup modal prompts you to paste an API key—log in to your YouTube Transcript vendor account, generate a new key under API Access, and copy it. 4. Paste the key into Switchy and click Authorize; Switchy confirms the connection with a green checkmark. 5. Open any Project, type '@YouTube Transcript get transcript for https://youtube.com/watch?v=example' in the chat, and press Enter. 6. The MCP fetches the video's captions and replies with the stored transcript ID; if the video has no captions the response explains that. 7. Use 'get stored transcript' with that ID to retrieve the full text without consuming additional credits. 8. For batch jobs or channel lookups, reference the tool names shown in the MCP's auto-complete menu.
What teammates see: by default, memories from YouTube Transcript are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Projects have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Summarize Keynote
@YouTube Transcript get the transcript for https://youtube.com/watch?v=dQw4w9WgXcQ then summarize the key takeaways in bullet points.
Batch Competitor Videos
@YouTube Transcript get transcripts for these competitor demo URLs as a batch, then highlight recurring product claims across all videos.
Search Tutorial Library
@YouTube Transcript list stored transcripts and show me any that mention 'API authentication' in the title or description.
Check Job Status
@YouTube Transcript check the status of batch job abc123 and return any completed transcripts so far.
Resolve Channel Uploads
@YouTube Transcript resolve the uploads for channel UC_x5XG1OV2P6uZZ5FSM9Ttw and list the ten most recent video titles with URLs.
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@YouTube Transcript fetch the transcript for https://youtube.com/watch?v=dQw4w9WgXcQ and summarize the main topics covered in the first 5 minutes
The MCP retrieved the video's closed captions and stored the transcript in your account. The first 5 minutes cover an introduction to the speaker's background in software architecture, followed by a discussion of microservices trade-offs—specifically latency versus maintainability—and a brief case study from a 2019 migration project. The speaker emphasizes that distributed systems require explicit error-handling contracts between services.
This example shows the read-and-reason workflow: GET_VIDEO_TRANSCRIPT pulls captions (consuming provider credits for uncached videos), then the AI synthesizes the content. The tool waits up to 20 seconds; longer videos may time out and require polling GET_VIDEO_TRANSCRIPT_JOB_STATUS. ASR is never triggered—only existing captions are retrieved.
@YouTube Transcript list all transcripts I've stored in the last 30 days, filtered to videos longer than 20 minutes
Your account holds 14 transcripts from the past month matching that duration threshold. Results include a 47-minute conference talk on Kubernetes networking (stored Jan 12), a 38-minute product demo (Jan 9), and a 22-minute tutorial on React hooks (Jan 6). Each entry shows video title, channel name, duration, storage timestamp, and available language codes. The list is paginated; 11 additional matches are available on the next page.
LIST_STORED_TRANSCRIPTS demonstrates the MCP's search and inventory capabilities without consuming new credits—it only reads what you've already fetched. Pagination means large result sets require multiple calls. This is useful for auditing usage or finding transcripts to reuse across Projects without re-fetching.
@YouTube Transcript get transcripts for these 6 tutorial videos in batch, then draft a combined study guide covering the shared concepts across all of them
The MCP queued a batch job and retrieved captions for all 6 videos (4 were cached; 2 consumed new credits). Shared concepts identified: dependency injection appears in 5 videos, test-driven development in 4, and CI/CD pipeline setup in 3. The draft study guide groups these themes, cross-references timestamps where each instructor explains the same pattern differently, and flags one video that uses outdated tooling (Docker Compose v1 syntax) as a point of caution.
GET_VIDEO_TRANSCRIPTS_BATCH handles 1–10 videos at once, making it efficient for curriculum analysis or competitive research. Cost scales with uncached requests, so batch size affects your monthly budget. The 20-second wait may time out on large batches; use GET_VIDEO_TRANSCRIPTS_BATCH_STATUS to poll completion if needed.
Use-case deep-dives
When batch transcript retrieval beats manual note-taking
A three-person content team reviews 15-20 competitor YouTube videos every Monday to spot trends and extract quotes for their own scripts. Without this MCP, someone watches at 1.5x speed and takes notes. With it, they run Get Video Transcripts Batch on Sunday night, then search the stored transcripts during standup using List Stored Transcripts. The win is real if the videos average over eight minutes—shorter clips don't justify the setup cost. The MCP consumes provider credits per uncached video, so teams watching the same channels weekly should track whether the cache hit rate justifies the monthly spend. If your research list changes completely each week, the credit burn adds up fast. Buy this if your team watches more than ten videos per week and needs searchable text, not just summaries.
Why this MCP isn't built for internal meeting transcripts
A five-person customer success team records onboarding calls as unlisted YouTube videos and wants to pull transcripts into Switchy for post-call summaries. This MCP can technically fetch those transcripts using Get Video Transcript, but it's the wrong tool. YouTube's caption system adds 30-90 seconds of lag after upload, and the MCP waits up to 20 seconds per job—so you're looking at two minutes minimum before the transcript lands in Switchy. Teams doing this workflow more than twice a week should use a dedicated meeting transcription MCP that hooks Zoom or Google Meet directly. The YouTube Transcript MCP shines when you're analyzing public or competitor content, not your own recordings. If you're already uploading to YouTube for other reasons and can tolerate the delay, it works, but don't choose YouTube as your recording platform just to use this integration.
When channel-level research justifies the Basic tier
A solo YouTube creator in the productivity niche wants to analyze what topics competitors covered in the last quarter without watching 80 videos. They use Resolve Channel Videos to pull upload metadata for three competitor channels, then run Get Video Transcripts Batch on the 15 most-viewed videos from each. The metadata step requires the Basic tier and counts against a monthly channel allowance, so this workflow makes sense if you're scanning channels once or twice a month, not daily. The stored transcripts stay in the account, so follow-up searches with List Stored Transcripts are free. The break-even point is around six hours of manual watching per month—if you're spending less time than that on competitor research, the API key setup and credit costs aren't worth it. Buy this if you're running quarterly landscape reviews or building a content strategy database, not if you're just checking one video occasionally.
Frequently asked
What does the YouTube Transcript MCP do in Switchy?
It fetches and stores YouTube video captions in your connected account. The MCP pulls existing captions from YouTube — it never starts automatic speech recognition. You can retrieve single videos, batch up to ten at once, or search transcripts you've already stored. Channel resolution lets you list a creator's uploads without transcribing them.
Do I need a YouTube Transcript API key to connect this MCP?
Yes. The integration uses API_KEY authentication, so you'll need credentials from the YouTube Transcript provider. This is separate from a Google account — you're authenticating with the transcript service, not YouTube directly. The key ties transcript storage and retrieval credits to your provider account.
Can this MCP transcribe videos that don't have captions?
No. The MCP only fetches captions YouTube already has — closed captions uploaded by the creator or auto-generated by YouTube itself. If a video has no captions, the tool returns nothing. For videos without captions, you need a separate speech-to-text service; this integration won't start ASR.
Why use this instead of copying captions from YouTube's player?
Manual copying breaks at scale and loses timestamp metadata. This MCP stores transcripts in a searchable library, handles batch requests, and tracks job status when fetches time out. If your team references video content regularly — research, content ops, compliance review — the structured storage beats ad-hoc copy-paste.
Does fetching transcripts count against my plan limits?
It counts against your YouTube Transcript provider account, not Switchy. Each uncached video consumes retrieval credits with the transcript service. Channel resolution on Basic or higher plans may count toward a monthly channel allowance. Check your provider dashboard for credit usage; Switchy just routes the requests.