mcp-youtube

MCP.Pizza Chef: adhikasp

The mcp-youtube server is a Model Context Protocol server designed to download and provide YouTube video transcripts, including timestamps, for integration with large language models (LLMs). It supports fetching transcripts using either YouTube video IDs or full URLs, making it versatile for various applications. This server works seamlessly with any MCP-compatible client, allowing developers to enrich their AI workflows with accurate, time-stamped YouTube subtitles. It simplifies the process of extracting video context for tasks like content summarization, analysis, or enhanced conversational AI experiences.

Use This MCP server To

Fetch YouTube video transcripts for LLM context Integrate YouTube subtitles into AI workflows Extract time-stamped transcripts from YouTube URLs Support video content summarization with transcripts Enable LLMs to reference YouTube video dialogue Provide subtitle data for video analysis tools

README

YouTube MCP Server

A Model Context Protocol server that allows you to download subtitles from YouTube and connect them to a LLM.

Features

Download transcripts from YouTube videos
Support for both video IDs and full YouTube URLs
Timestamps included in transcript
Works with any MCP-compatible client

Usage

In your MCP client configuration:

"mcpServers": {
    "youtube": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/adhikasp/mcp-youtube", "mcp-youtube"]
    },
}

Development

Clone the repository
Create and activate virtual environment using uv:

uv venv
source .venv/bin/activate  # On Unix/MacOS
# or .venv\Scripts\activate  # On Windows

Install dependencies:

uv sync

Run the server:

python -m youtube_mcp

License

MIT

mcp-youtube FAQ

How do I install the mcp-youtube server?

Clone the repository, create and activate a virtual environment, install dependencies with 'uv sync', then run the server using 'python -m youtube_mcp'.

Can mcp-youtube handle both video IDs and full YouTube URLs?

Yes, it supports fetching transcripts using either YouTube video IDs or full URLs.

Does mcp-youtube include timestamps in the transcripts?

Yes, the transcripts downloaded include timestamps for each subtitle segment.

How do I configure mcp-youtube in my MCP client?

Add the mcp-youtube server in your MCP client configuration with the command 'uvx' and the appropriate GitHub repository URL as shown in the usage example.

Is mcp-youtube compatible with all MCP clients?

Yes, it works with any MCP-compatible client to provide YouTube transcript data.

What license governs the use of mcp-youtube?

The mcp-youtube server is licensed under the MIT License.

Can I use mcp-youtube transcripts with LLMs like OpenAI, Claude, or Gemini?

Yes, transcripts fetched by mcp-youtube can be integrated with LLMs such as OpenAI, Anthropic Claude, and Google Gemini for enhanced context.