YouTube Toolbox

An MCP server that provides AI assistants with powerful tools to interact with YouTube, including video searching, transcript extraction, comment retrieval, and more.

py-mcp-youtube-toolbox provides the following YouTube-related functionalities:

- Search YouTube videos with advanced filtering options
- Get detailed information about videos and channels
- Retrieve video comments with sorting options
- Extract video transcripts and captions in multiple languages
- Find related videos for a given video
- Get trending videos by region
- Generate summaries of video content based on transcripts
- Advanced transcript analysis with filtering, searching, and multi-video capabilities

- Prerequisites
- Installation
- Configure MCP Settings
- Tools Documentation

- Video Tools
- Channel Tools
- Transcript Tools
- Prompt Tools
- Resource Tools
- Python: Install Python 3.12 or higher
- YouTube API Key:

- Go toGoogle Cloud Console
- Create a new project or select an existing one
- Enable the YouTube Data API v3:
- Go to "APIs & Services" > "Library"
- Search for and enable "YouTube Data API v3"
- Go to "APIs & Services" > "Credentials"
- Click "Create Credentials" > "API key"
- Note down your API key

git clone https://github.com/jikime/py-mcp-youtube-toolbox.git cd py-mcp-youtube-toolbox

curl -LsSf https://astral.sh/uv/install.sh | sh

uv venv -p 3.12 source .venv/bin/activate # On MacOS/Linux # or .venv\Scripts\activate # On Windows

cp env.example .env vi .env # Update with your YouTube API key YOUTUBE_API_KEY=your_youtube_api_key

docker build -t py-mcp-youtube-toolbox .

docker run -e YOUTUBE_API_KEY=your_youtube_api_key py-mcp-youtube-toolbox

npx -y @smithery/cli install @jikime/py-mcp-youtube-toolbox --client claude

{ "mcpServers": { "YouTube Toolbox": { "command": "/path/to/bin/uv", "args": [ "--directory", "/path/to/py-mcp-youtube-toolbox", "run", "server.py" ], "env": { "YOUTUBE_API_KEY": "your_youtube_api_key" } } } }

{ "mcpServers": { "YouTube Toolbox": { "command": "/path/to/bin/uv", "args": [ "--directory", "/path/to/py-mcp-youtube-toolbox", "run", "server.py" ], "env": { "YOUTUBE_API_KEY": "your_youtube_api_key" } } } }

{ "mcpServers": { "YouTube Toolbox": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "YOUTUBE_API_KEY=your_youtube_api_key", "py-mcp-youtube-toolbox" ] } } }

- search_videos: Search for YouTube videos with advanced filtering options (channel, duration, region, etc.)
- get_video_details: Get detailed information about a specific YouTube video (title, channel, views, likes, etc.)
- get_video_comments: Retrieve comments from a YouTube video with sorting options
- get_related_videos: Find videos related to a specific YouTube video
- get_trending_videos: Get trending videos on YouTube by region

- get_video_transcript: Extract transcripts/captions from YouTube videos in specified languages
- get_video_enhanced_transcript: Advanced transcript extraction with filtering, search, and multi-video capabilities

- transcript_summary: Generate summaries of YouTube video content based on transcripts with customizable options

- youtube://available-youtube-tools: Get a list of all available YouTube tools
- youtube://video/{video_id}: Get detailed information about a specific video
- youtube://channel/{channel_id}: Get information about a specific channel
- youtube://transcript/{video_id}?language={language}: Get transcript for a specific video

For local testing, you can use the included client script:

# Example: Search videos uv run client.py search_videos query="MCP" max_results=5 # Example: Get video details uv run client.py get_video_details video_id=zRgAEIoZEVQ # Example: Get channel details uv run client.py get_channel_details channel_id=UCRpOIr-NJpK9S483ge20Pgw # Example: Get video comments uv run client.py get_video_comments video_id=zRgAEIoZEVQ max_results=10 order=time # Example: Get video transcript uv run client.py get_video_transcript video_id=zRgAEIoZEVQ language=ko # Example: Get related videos uv run client.py get_related_videos video_id=zRgAEIoZEVQ max_results=5 # Example: Get trending videos uv run client.py get_trending_videos region_code=ko max_results=10 # Example: Advanced transcript extraction uv run client.py get_video_enhanced_transcript video_ids=zRgAEIoZEVQ language=ko format=timestamped include_metadata=true start_time=100 end_time=200 query=에이전트 case_sensitive=true segment_method=equal segment_count=2 # Example:

Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.

BYOK Reddit/YouTube research CLI with a tamper-evident audit log and an MCP server.

An agent-based tool for web search and advanced research, including analysis of PDFs, documents, images, and YouTube transcripts.

Finds background music for YouTube shorts by analyzing script content and recommending tracks from YouTube Music.

An MCP server providing search capabilities for Reddit, YouTube, and Twitter.

A search tool for finding movies and TV shows from multiple video sources with link validation.

Provides search capabilities and data retrieval from SerpAPI and YouTube for AI assistants.

Get YouTube transcripts, search videos, browse channels, and extract playlists from any AI agent — powered by TranscriptAPI.com with no API key required.

Self-hosted YouTube research MCP with 17 tools for search, transcripts, timestamped frames, comments, and private local semantic corpora.

Search a YouTube video's transcript and read its frames — every answer cites a clickable timestamp.

Search YouTube videos and retrieve their transcripts using the YouTube API.