YouTube Transcript MCP Server
It lets LLM agents retrieve YouTube transcripts and video metadata, with pagination and language/proxy support.
Fetch a plain-text transcript for a YouTube video.
Fetch a timestamped transcript with snippet text, start times, and durations.
List available transcript languages, including manual and auto-generated options.
Retrieve video metadata: title, description, uploader, upload date, and duration.
Select a preferred transcript language.
Page through long transcripts using
next_cursor.Use proxy configuration to work around YouTube rate limits and IP bans.
Retrieves transcripts from YouTube videos, allowing users to fetch transcripts in different languages from specified YouTube video URLs
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@YouTube Transcript MCP Server get transcript for https://youtu.be/dQw4w9WgXcQ"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
English | 日本語
YouTube Transcript MCP Server
A Model Context Protocol (MCP) server that fetches transcripts and metadata from YouTube videos directly into your LLM workflows.
Designed specifically for AI agents, it seamlessly handles long-form videos through automatic pagination and provides robust proxy support to circumvent YouTube rate limits and IP bans.

The header image was generated with Muse (Muse Image).
Key Features
Rich Transcript Retrieval: Fetch raw text, timestamped segments, and video metadata in multiple languages.
Smart Chunking & Pagination: Automatically chunks long transcripts (default: 50,000 characters) to prevent context window overflow, letting models page through hours of video effortlessly.
Resilient Proxy Support: Built-in support for residential proxies (Webshare, ScrapingAnt) and standard HTTP/HTTPS proxies to prevent IP blocks.
Universal Compatibility: Works with Claude Desktop, Cursor, LM Studio, Goose, and any standard MCP client.
Related MCP server: YouTube Transcript Server
Quick Start & Installation
You'll needuv installed on your system to use uvx command.
This server communicates via standard stdio.
Most MCP clients can run it directly using uvx (part of Astral uv).
General Configuration (Standard MCP JSON)
Add this entry to your client's MCP configuration file (typically under mcpServers):
{
"mcpServers": {
"youtube-transcript": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/jkawamoto/mcp-youtube-transcript",
"mcp-youtube-transcript"
]
}
}
}Claude Desktop
GUI (Drag & Drop): Download the
.mcpbbundle from the Releases page and drop it into your Claude Desktop Settings.Manual Config: Add the JSON above to
claude_desktop_config.json(restart Claude Desktop after saving):macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
Cursor
Go to Cursor Settings > Features > MCP Servers.
Click + Add New MCP Server.
Name:
youtube-transcript, Type:command.Command:
uvx --from git+https://github.com/jkawamoto/mcp-youtube-transcript mcp-youtube-transcript
Goose
Please refer to this tutorial for detailed installation instructions: YouTube Transcript Extension.
LM Studio
To configure this server for LM Studio, click the button below.
Using Docker
A Docker image for this server is available on Docker Hub. Please refer to the Docker Hub page for detailed usage instructions and documentation.
Available Tools
The server registers the following MCP tools for LLM agents:
Tool | Description |
| Retrieves the plain-text transcript for a YouTube video URL. |
| Retrieves transcript segments with start times and durations. |
| Lists all available transcript languages (manual & auto-generated). |
| Fetches video metadata such as title and channel information. |
get_transcripturl(string, required): Full YouTube video URL.lang(string, optional): Preferred language code (defaults to"en").next_cursor(integer, optional): Cursor to fetch the next chunk for long videos.
get_timed_transcripturl(string, required): Full YouTube video URL.lang(string, optional): Preferred language code (defaults to"en").next_cursor(integer, optional): Cursor to fetch the next chunk.
get_available_languagesurl(string, required): Full YouTube video URL.
get_video_infourl(string, required): Full YouTube video URL.
Advanced Configuration
Handling Long Videos (Pagination)
Long videos (e.g., lectures, conferences, podcast episodes) can quickly exceed LLM token context limits.
By default, transcripts exceeding 50,000 characters are chunked. When a response is split,
a next_cursor is provided so the LLM agent can autonomously query the rest.
To customize the chunk character limit, supply --response-limit.
To disable pagination and fetch the entire transcript at once, set --response-limit to a negative value (e.g., -1):
{
"mcpServers": {
"youtube-transcript": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/jkawamoto/mcp-youtube-transcript",
"mcp-youtube-transcript",
"--response-limit",
"15000"
]
}
}
}Avoiding IP Bans (Proxy Setup)
YouTube aggressively blocks automated transcript requests from cloud providers and data center IPs. Using residential or rotating proxies ensures uninterrupted access.
1. Webshare Residential Proxy
Set credentials via environment variables or command-line flags:
{
"mcpServers": {
"youtube-transcript": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/jkawamoto/mcp-youtube-transcript",
"mcp-youtube-transcript"
],
"env": {
"WEBSHARE_PROXY_USERNAME": "your_username",
"WEBSHARE_PROXY_PASSWORD": "your_password"
}
}
}
}(CLI equivalents: --webshare-proxy-username and --webshare-proxy-password)
2. ScrapingAnt
If using ScrapingAnt, supply your API token:
{
"mcpServers": {
"youtube-transcript": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/jkawamoto/mcp-youtube-transcript",
"mcp-youtube-transcript"
],
"env": {
"SCRAPINGANT_API_TOKEN": "your_api_token"
}
}
}
}(CLI equivalent: --scrapingant-api-token)
Accessing YouTube requires a paid ScrapingAnt Web Scraping API subscription. YouTube access requires residential proxies, which consume more ScrapingAnt credits than standard proxy requests. See the ScrapingAnt credit cost documentation for details.
3. Standard / Generic HTTP & HTTPS Proxies
Specify custom proxy endpoints via HTTP_PROXY / HTTPS_PROXY (or --http-proxy / --https-proxy):
{
"mcpServers": {
"youtube-transcript": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/jkawamoto/mcp-youtube-transcript",
"mcp-youtube-transcript"
],
"env": {
"HTTPS_PROXY": "http://username:password@proxy.example.com:8080"
}
}
}
}For more details, please visit: Working around IP bans - YouTube Transcript API.
License
This application is licensed under the MIT License. See the LICENSE file for more details.
Available Tools
4 toolsget_available_languagesA
Retrieves the available languages for the video.
Inputs: url (required). Returns: result
get_timed_transcriptB
Retrieves the transcript of a YouTube video with timestamps.
Inputs: url (required), lang, next_cursor. Returns: Transcript of a YouTube video with timestamps.
get_transcriptC
Retrieves the transcript of a YouTube video.
Inputs: url (required), lang, next_cursor. Returns: Transcript of a YouTube video.
get_video_infoC
Retrieves the video information.
Inputs: url (required). Returns: Video information.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool targets a distinct output type, though get_transcript and get_timed_transcript overlap heavily in purpose and are only separated by the presence of timestamps. get_available_languages and get_video_info are clearly distinct from transcript retrieval.
All four tools follow a consistent get_noun snake_case pattern, making the set highly predictable and readable.
Four tightly scoped tools is appropriate for a focused YouTube transcript server. Each tool earns its place without extraneous surface area.
Core needs—transcript text, timestamped transcript, language availability, and video metadata—are covered. Minor gaps like transcript translation or search within a transcript are not present but are not essential to the stated purpose.
Maintenance
Related MCP Connectors
Fetch the transcript of any YouTube video (plain text or timestamped segments, in any available caption language), search YouTube for videos and channels, list a channel's uploads, Shorts, playlists and community posts, search inside one channel, and list every video in a playlist. Hosted Streamable HTTP server from getyoutubetranscript.com; sign in with OAuth or an API key. Credit-based: one credit per successful call.
Transcripts of YouTube videos, playlists and channels with timestamps; SRT or WebVTT too.
Transcripts, translations, summaries, subtitles, and search for public YouTube videos.
Turn YouTube videos and audio or video files into searchable, exportable transcripts.
Related MCP Servers
- AlicenseAqualityDmaintenanceA Model Context Protocol server that enables retrieval of transcripts from YouTube videos. This server provides direct access to video captions and subtitles through a simple interface.1607MIT
- AlicenseBqualityDmaintenanceA Model Context Protocol server that enables retrieval of transcripts from YouTube videos with language-specific support.11MIT
- AlicenseAqualityDmaintenanceA Model Context Protocol server that enables retrieval of transcripts from YouTube videos. This server provides direct access to video transcripts and subtitles through a simple interface, making it ideal for content analysis and processing.1404 npm39MIT
- AlicenseBqualityDmaintenanceAn MCP server designed to fetch transcripts for YouTube videos. It enables AI tools to access video text content for tasks like summarization, analysis, and key takeaway extraction.174MIT
Appeared in Searches
- Methods for Searching and Parsing Online Documentation
- A platform for streaming and sharing videos
- Guidance for writing a conclusion for a long text
- A server for finding research papers, extracting content, and retrieving relevant repository codes
- A tool or service that assists in real-time information search