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.

This server cannot be installed

security - not tested

license - not found

quality - not tested

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.

Enables AI language models to interact with YouTube content through a standardized interface, providing tools for retrieving video information, transcripts, channel analytics, and trend analysis.

Related MCP Servers

YouTube MCP Server
ZubeidHendricks
-
security
F
license
-
quality
This 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 -
169
179
TypeScript
Youtube-Summarizer MCP Server
trilogy-group
-
security
F
license
-
quality
Enables AI applications to integrate with YouTube-Summarizer's APIs through the MCP protocol, offering local tool-based interaction for summarizing YouTube content.
Last updated -
1
Python
Youtube MCP Server
sparfenyuk
A
security
A
license
A
quality
Bridges YouTube API and AI assistants, enabling video analysis by downloading and processing closed captions to create summaries of YouTube videos.
Last updated -
1
3
Python
MIT License
YouTube Transcript Extractor MCP
MalikElate
-
security
F
license
-
quality
A 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 -
6
1
TypeScript

View all related MCP servers

YouTube MCP Server