About Youtube Data MCP Server
Youtube Data MCP Server is an MCP server published by icraft2170 in the Content category: mCP server: Youtube Data MCP Server.
The repository has 65 stars and 29 forks, with the last commit a year ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/icraft2170/youtube-data-mcp-serverThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (9)
compareVideosCompares multiple videos based on their statistics. Returns a comparison of view counts, like counts, comment counts, and other metrics for the specified videos. Use this when you want to analyze the performance of multiple videos side by side.
Parameters not published.
getChannelStatisticsRetrieves statistics for multiple channels. Returns detailed metrics including subscriber count, view count, and video count for each channel. Use this when you need to analyze the performance and reach of multiple YouTube channels.
Parameters not published.
getChannelTopVideosRetrieves the top videos from a specific channel. Returns a list of the most viewed or popular videos from the channel, based on view count. Use this when you want to identify the most successful content from a channel.
Parameters not published.
getRelatedVideosRetrieves related videos for a specific video. Returns a list of videos that are similar or related to the specified video, based on YouTube
Parameters not published.
getTranscriptsRetrieves transcripts for multiple videos. Returns the text content of videos
Parameters not published.
getTrendingVideosRetrieves trending videos based on region and category. Returns a list of videos that are currently popular in the specified region and category. Use this when you want to discover what
Parameters not published.
getVideoDetailsGet detailed information about multiple YouTube videos. Returns comprehensive data including video metadata, statistics, and content details. Use this when you need complete information about specific videos.
Parameters not published.
getVideoEngagementRatioCalculates the engagement ratio for multiple videos. Returns metrics such as view count, like count, comment count, and the calculated engagement ratio for each video. Use this when you want to measure the audience interaction with videos.
Parameters not published.
searchVideosSearches for videos based on a query string. Returns a list of videos matching the search criteria, including titles, descriptions, and metadata. Use this when you need to find videos related to specific topics or keywords.
Parameters not published.
Ask AI
Ask AI about Youtube Data MCP Server
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 4 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- !License declaredNo license file. Legally you have no right to use it in a product.
- !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
README
YouTube MCP Server
A Model Context Protocol (MCP) server implementation utilizing the YouTube Data API. It allows AI language models to interact with YouTube content through a standardized interface.
Key Features
Video Information
- Retrieve detailed video information (title, description, duration, statistics)
- Search for videos by keywords
- Get related videos based on a specific video
- Calculate and analyze video engagement ratios
Transcript/Caption Management
- Retrieve video captions with multi-language support
- Specify language preferences for transcripts
- Access time-stamped captions for precise content reference
Channel Analysis
- View detailed channel statistics (subscribers, views, video count)
- Get top-performing videos from a channel
- Analyze channel growth and engagement metrics
Trend Analysis
- View trending videos by region and category
- Compare performance metrics across multiple videos
- Discover popular content in specific categories
Available Tools
The server provides the following MCP tools:
| Tool Name | Description | Required Parameters |
|---|---|---|
getVideoDetails |
Get detailed information about multiple YouTube videos including metadata, statistics, and content details | videoIds (array) |
searchVideos |
Search for videos based on a query string | query, maxResults (optional) |
getTranscripts |
Retrieve transcripts for multiple videos | videoIds (array), lang (optional) |
getRelatedVideos |
Get videos related to a specific video based on YouTube's recommendation algorithm | videoId, maxResults (optional) |
getChannelStatistics |
Retrieve detailed metrics for multiple channels including subscriber count, view count, and video count | channelIds (array) |
getChannelTopVideos |
Get the most viewed videos from a specific channel | channelId, maxResults (optional) |
getVideoEngagementRatio |
Calculate engagement metrics for multiple videos (views, likes, comments, and engagement ratio) | videoIds (array) |
getTrendingVideos |
Get currently popular videos by region and category | regionCode (optional), categoryId (optional), maxResults (optional) |
compareVideos |
Compare statistics across multiple videos | videoIds (array) |
Installation
Automatic Installation via Smithery
Automatically install YouTube MCP Server for Claude Desktop via Smithery:
npx -y @smithery/cli install @icraft2170/youtube-data-mcp-server --client claude
Manual Installation
# Install from npm
npm install youtube-data-mcp-server
# Or clone repository
git clone https://github.com/icraft2170/youtube-data-mcp-server.git
cd youtube-data-mcp-server
npm install
Environment Configuration
Set the following environment variables:
YOUTUBE_API_KEY: YouTube Data API key (required)YOUTUBE_TRANSCRIPT_LANG: Default caption language (optional, default: 'ko')
MCP Client Configuration
Add the following to your Claude Desktop configuration file:
{
"mcpServers": {
"youtube": {
"command": "npx",
"args": ["-y", "youtube-data-mcp-server"],
"env": {
"YOUTUBE_API_KEY": "YOUR_API_KEY_HERE",
"YOUTUBE_TRANSCRIPT_LANG": "ko"
}
}
}
}
YouTube API Setup
- Access Google Cloud Console
- Create a new project or select an existing one
- Enable YouTube Data API v3
- Create API credentials (API key)
- Use the generated API key in your environment configuration
Development
# Install dependencies
npm install
# Run in development mode
npm run dev
# Build
npm run build
Network Configuration
The server exposes the following ports for communication:
- HTTP: 3000
- gRPC: 3001
System Requirements
- Node.js 18.0.0 or higher
Security Considerations
- Always keep your API key secure and never commit it to version control systems
- Manage your API key through environment variables or configuration files
- Set usage limits for your API key to prevent unauthorized use
License
This project is licensed under the MIT License. See the LICENSE file for details.
README fetched from the repository 4 days ago. The original is authoritative.