yt-mcp-server
Provides tools for working with YouTube URLs, video IDs, and thumbnails.
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., "@yt-mcp-server normalize this YouTube URL: 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.
yt-mcp-server
MCP server with various utility functions for dealing with YouTube data. This server provides tools for working with YouTube URLs, video IDs, and thumbnails.
📖 Resources
Related MCP server: YouTube MCP Server
Prerequisites
Python 3.12 or higher
UV package manager
Setup
1. Install UV
If you haven't installed UV yet, you can install it using:
brew install uv
# alternatively curl -LsSf https://astral.sh/uv/install.sh | sh2. Installation Methods
Method 1: Install from GitHub (Recommended)
This is the simplest way to install and run the server:
uvx --from git+https://github.com/kdr/yt-mcp-server.git serverMethod 2: Local Development Setup
If you want to modify the code locally:
git clone https://github.com/kdr/yt-mcp-server.git
cd yt-mcp-server
uv venv
source .venv/bin/activate # On Unix/macOS
# or
.venv\Scripts\activate # On Windows
uv pip install -e .3. Configure MCP Client
Add the following configuration to your MCP client settings:
{
"mcpServers": {
"yt-mcp-server": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/kdr/yt-mcp-server.git",
"server"
]
}
}
}For local development (Method 2), use this configuration instead:
{
"mcpServers": {
"yt-mcp-server": {
"command": "uv",
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/PARENT/FOLDER/yt-mcp-server/yt_mcp_server",
"run",
"main.py"
]
}
}
}Available Tools
The following tools are available to the LLM:
get_watch_url: Returns the YouTube watch URL for a given video ID, optionally starting at a specific timeParameters:
video_id: The YouTube video IDstart_time: (Optional) The start time in seconds
get_thumbnail_url: Returns the thumbnail URL for a given YouTube video IDParameters:
video_id: The YouTube video ID
get_normalized_url: Normalizes various YouTube URL formats to the canonical watch URL and extracts the video IDParameters:
url: The YouTube URL to normalize
Available Tools
3 toolsget_normalized_urlA
Returns the normalized YouTube URL for a given URL.
Args:
url: The YouTube URL to normalize.
Inputs: url (required).
get_thumbnail_urlB
Returns the thumbnail URL for a given YouTube video ID.
Args:
video_id: The YouTube video ID.
Inputs: video_id (required).
get_watch_urlA
Returns the YouTube watch URL for a given video ID, optionally starting at a specific time.
Args:
video_id: The YouTube video ID.
start_time: The start time in seconds
Inputs: video_id (required), start_time.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool targets a distinct output: watch URL, thumbnail URL, and normalized URL. Inputs differ (video ID vs. URL), so there is no overlap or ambiguity.
All tools follow a consistent get_ verb_noun pattern, clearly indicating the returned resource. The naming convention is uniform and predictable.
The server is narrowly scoped to YouTube URL helpers, and 3 tools is an appropriate size for this purpose. Each tool earns its place without redundancy.
The server covers the core operations for URL generation, thumbnails, and normalization. The get_normalized_url tool effectively handles URL parsing and standardization, leaving no obvious missing functionality.
Related MCP Connectors
YouTube discovery, transcripts, library search, and monitors with API keys or OAuth.
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.
YouTube search, whole channels, video stats, comments and full transcripts with timestamps.
YouTube video metadata, transcripts and channel data by URL or @handle. No API key. Pay per result.
Related MCP Servers
- AlicenseCqualityDmaintenanceThis server allows AI language models to interact with YouTube content through a standardized interface, providing features such as video and channel information retrieval, transcript management, and playlist operations.10530 npm598MIT
- AlicenseBqualityBmaintenanceA server that enables interaction with YouTube data through the Model Context Protocol, allowing users to search videos, retrieve detailed information about videos/channels, and fetch comments.12192 npm27MIT
- FlicenseNot gradedqualityDmaintenanceAn MCP server that enables interaction with the YouTube Data API, allowing users to search videos, get video and channel details, analyze trends, and fetch video transcripts.-
- AlicenseBqualityBmaintenanceAn MCP server that enables the extraction of transcripts and detailed metadata from YouTube videos. It allows users to retrieve video information like titles and descriptions, as well as transcripts with optional timestamps and language selection.2MIT