YouTube-MCP

Name: YouTube-MCP
Author: CodeWizzard01

@CodeWizzard01

Repository

About YouTube-MCP

No overview available yet

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "youtube-mcp-server-codewizzard01": {
      "command": "docker",
      "args": [
        "run",
        "-e",
        "YOUTUBE_API_KEY=<your_api_key_here>",
        "-p",
        "8085:8080",
        "codewizard01/youtube-mcp:latest"
      ]
    }
  }
}

Tools

Search for videos on YouTube using a query string.

Get transcript for a YouTube video by video ID.

Get details of a YouTube video using its video ID.

Get thumbnail URLs for a YouTube video by video ID.

List comments for a YouTube video by video ID. (Public comments only)

Get information about a YouTube channel by channel ID.

List playlists for a YouTube channel by channel ID.

List channel sections (shelves) for a YouTube channel by channel ID.

List videos in a YouTube playlist by playlist ID.

List activities for a YouTube channel by channel ID. (Public activities only)

List video categories available in a region.

Overview

What is YouTube-MCP?

YouTube-MCP is a Model Context Protocol server that provides search, transcript, and metadata tools for YouTube. It is built using the Java MCP SDK and Spring AI, with a JavaScript component for transcript extraction.

How to use YouTube-MCP?

Run the server as a Docker container with the YOUTUBE_API_KEY environment variable, or from an IDE using Java 24 and Maven. Connect to an MCP host by adding an SSE endpoint (http://localhost:8085) or a stdio command (java -jar youtube-mcp.jar) to the MCP config file.