Integrations
Leverages Google Cloud Platform services, specifically requiring YouTube Data API v3 credentials for authentication and access to YouTube data.
Provides tools for interacting with YouTube, including video searching, transcript extraction, comment retrieval, related video discovery, trending video lists, channel information retrieval, and transcript analysis with filtering and summarization capabilities.
py-mcp-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.
Overview
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
Table of Contents
Prerequisites
- Python: Install Python 3.12 or higher
- YouTube API Key:
- Go to Google 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"
- Create credentials:
- Go to "APIs & Services" > "Credentials"
- Click "Create Credentials" > "API key"
- Note down your API key
Installation
Git Clone
Configuration
- Install UV package manager:
- Create and activate virtual environment:
- Install dependencies:
- Environment variables:
Using Docker
- Build the Docker image:
- Run the container:
Using Local
- Run the server:
- Run the MCP Inspector:
Configure MCP Settings
Add the server configuration to your MCP settings file:
Claude desktop app
- To install automatically via Smithery:
- To install manually
open
~/Library/Application Support/Claude/claude_desktop_config.json
Add this to the mcpServers
object:
Cursor IDE
open ~/.cursor/mcp.json
Add this to the mcpServers
object:
for Docker
Tools Documentation
Video Tools
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 optionsget_related_videos
: Find videos related to a specific YouTube videoget_trending_videos
: Get trending videos on YouTube by region
Channel Tools
get_channel_details
: Get detailed information about a YouTube channel (name, subscribers, views, etc.)
Transcript Tools
get_video_transcript
: Extract transcripts/captions from YouTube videos in specified languagesget_video_enhanced_transcript
: Advanced transcript extraction with filtering, search, and multi-video capabilities
Prompt Tools
transcript_summary
: Generate summaries of YouTube video content based on transcripts with customizable options
Resource Tools
youtube://available-youtube-tools
: Get a list of all available YouTube toolsyoutube://video/{video_id}
: Get detailed information about a specific videoyoutube://channel/{channel_id}
: Get information about a specific channelyoutube://transcript/{video_id}?language={language}
: Get transcript for a specific video
Development
For local testing, you can use the included client script:
License
MIT License
You must be authenticated.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
An MCP server that provides AI assistants with powerful tools to interact with YouTube, including video searching, transcript extraction, comment retrieval, and more.
Related MCP Servers
- -securityFlicense-qualityThis 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.Last updated -59135TypeScript
- -securityFlicense-qualityThe MCP Server integrates APIs from the Youtube-Summarizer as tools within the MCP protocol, allowing for local AI application interaction and tool utilization through natural language queries.Last updated -Python
- -securityAlicense-qualityAn MCP server that allows Claude and other AI assistants to interact with the YouTube API, providing tools to search videos/channels and retrieve detailed information about them.Last updated -1JavaScriptMIT License
- -securityFlicense-qualityA Model Context Protocol server that enables AI assistants to extract transcripts from YouTube videos, allowing AI to analyze and work with video content directly.Last updated -61TypeScript