YouTube Toolbox

Provides YouTube search, details, transcripts, comments, related/trending videos, and transcript-based summaries for MCP-enabled assistants.

python

20

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "jikime-py-mcp-youtube-toolbox": {
      "command": "/path/to/bin/uv",
      "args": [
        "--directory",
        "/path/to/py-mcp-youtube-toolbox",
        "run",
        "server.py"
      ],
      "env": {
        "YOUTUBE_API_KEY": "your_youtube_api_key"
      }
    }
  }
}

py-mcp-youtube-toolbox is an MCP server that lets you build AI assistants capable of interacting with YouTube data. You can search videos, fetch video and channel details, pull transcripts, extract comments, find related or trending videos, and generate content summaries from transcripts. This makes it easy to create chat-based assistants that understand YouTube content and guide your viewing or research workflows.

How to use

To use this MCP server, connect it to your MCP client and start conversations around YouTube data. You can perform practical tasks like searching for videos with specific filters, retrieving video details such as titles and view counts, pulling comments, getting transcripts in chosen languages, and generating summaries from transcripts. Use the available tools to compose prompts that combine multiple capabilities, for example: search for videos, fetch a transcript, and then generate a concise summary of the discussion in the video.

How to install

Prerequisites you need before installing: Python 3.12 or higher and a YouTube Data API key.

Step 1: Prepare your environment and API key.

Step 2: Install the required tooling to run MCP servers locally or via container. You can install UV for local environment management or run directly with MCP commands.

Step 3: Install dependencies and set up your environment variables as described in the configuration steps.

Configuration and runs

Set up your environment variable for the YouTube API key in all run configurations.

If you prefer running locally with MCP, you can start the server with a simple command and use the MCP Inspector to test prompts.

If you want to run via a container, you can start the Docker container with the API key supplied as an environment variable.

Development and tools details

This server exposes a range of YouTube-related capabilities that you can call through your MCP client. The main tool groups include Video Tools, Channel Tools, Transcript Tools, Prompt Tools, and Resource Tools.

Available tools

search_videos

Search for YouTube videos with advanced filtering options such as channel, duration, region, and other criteria.

get_video_details

Retrieve detailed information about a specific YouTube video, including title, channel, views, likes, and more.

get_video_comments

Fetch comments from a YouTube video with sorting options to surface the most relevant or latest comments.

get_related_videos

Find videos related to a given video to support discovery and continuation of topics.

get_trending_videos

Get trending videos by region to stay current with popular content.

get_channel_details

Obtain detailed information about a YouTube channel, including subscribers and total views.

get_video_transcript

Extract transcripts or captions from YouTube videos in specified languages.

get_video_enhanced_transcript

Advanced transcript extraction with filtering, search, and multi-video capabilities.

transcript_summary

Generate concise summaries of video content based on transcripts with customizable options.

youtube://available-youtube-tools

Get a list of all available YouTube tools provided by the server.

youtube://video/{video_id}

Get detailed information about a specific video by ID.

youtube://channel/{channel_id}

Get information about a specific channel by ID.

youtube://transcript/{video_id}?language={language}

Get transcript for a specific video in the requested language.