YouTube MCP Server

by icraft2170

Integrations

  • Requires setup of a YouTube Data API v3 key through Google Cloud Console to authenticate and access YouTube data.

  • Provides tools for retrieving video details, searching videos, getting transcripts, analyzing channels, calculating engagement metrics, and accessing trending content from the YouTube Data API.

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 NameDescriptionRequired Parameters
getVideoDetailsGet detailed information about multiple YouTube videos including metadata, statistics, and content detailsvideoIds (array)
searchVideosSearch for videos based on a query stringquery, maxResults (optional)
getTranscriptsRetrieve transcripts for multiple videosvideoIds (array), lang (optional)
getRelatedVideosGet videos related to a specific video based on YouTube's recommendation algorithmvideoId, maxResults (optional)
getChannelStatisticsRetrieve detailed metrics for multiple channels including subscriber count, view count, and video countchannelIds (array)
getChannelTopVideosGet the most viewed videos from a specific channelchannelId, maxResults (optional)
getVideoEngagementRatioCalculate engagement metrics for multiple videos (views, likes, comments, and engagement ratio)videoIds (array)
getTrendingVideosGet currently popular videos by region and categoryregionCode (optional), categoryId (optional), maxResults (optional)
compareVideosCompare statistics across multiple videosvideoIds (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

  1. Access Google Cloud Console
  2. Create a new project or select an existing one
  3. Enable YouTube Data API v3
  4. Create API credentials (API key)
  5. 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.

-
security - not tested
F
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.

  1. Key Features
    1. Video Information
    2. Transcript/Caption Management
    3. Channel Analysis
    4. Trend Analysis
  2. Available Tools
    1. Installation
      1. Automatic Installation via Smithery
      2. Manual Installation
    2. Environment Configuration
      1. MCP Client Configuration
        1. YouTube API Setup
          1. Development
            1. Network Configuration
              1. System Requirements
                1. Security Considerations
                  1. License

                    Related MCP Servers

                    • -
                      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 -
                      59
                      135
                      TypeScript
                      • Linux
                      • Apple
                    • -
                      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
                    • 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
                      • Apple
                    • -
                      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

                    ID: alxyqqw9qw