youtube-mcp
An MCP server for extracting YouTube video transcripts and metadata.
Configuration
{
"mcpServers": {
"youtube": {
"command": "uvx",
"args": ["youtube-mcp"]
}
}
}
Installation (Optional)
If you prefer to install globally:
pip install youtube-mcp
# or
uv tool install youtube-mcp
Tools
get_transcript
Get transcript text from a YouTube video.
| Parameter | Type | Description |
|---|---|---|
url |
string | YouTube URL or video ID |
language |
string | Language code (default: auto) |
with_timestamps |
bool | Include timestamps (default: false) |
Example:
// Input
{ "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" }
// Output
{
"video_id": "dQw4w9WgXcQ",
"language": "en",
"transcript": "We're no strangers to love\nYou know the rules and so do I..."
}
get_video_info
Get metadata from a YouTube video.
| Parameter | Type | Description |
|---|---|---|
url |
string | YouTube URL or video ID |
Example:
// Input
{ "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" }
// Output
{
"id": "dQw4w9WgXcQ",
"title": "Rick Astley - Never Gonna Give You Up",
"description": "...",
"duration": 213,
"channel": "Rick Astley",
"upload_date": "2009-10-25",
"view_count": 1500000000,
"available_languages": ["en", "ja", "es", "fr"]
}
License
MIT
