YouTube MCP Server

A Model Context Protocol (MCP) server that provides tools for searching YouTube videos, retrieving transcripts, and performing semantic search over video content.

Support Us

If you find this project helpful and would like to support future projects, consider buying us a coffee! Your support helps us continue building innovative AI solutions.

Your contributions go a long way in fueling our passion for creating intelligent and user-friendly applications.

Table of Contents

• YouTube MCP Server
• Features
• Prerequisites
• Installation
• Running the Server
  • 1. Direct Method
  • 2. Configure for Claude.app
• Available Tools
• Using with MCP Clients
  • Example Usage
• Debugging
• Contributing
• License

Features

• Search YouTube videos without using the official API
• Retrieve video transcripts
• Store video information and transcripts in a vector database
• Perform semantic search over stored video transcripts

Prerequisites

• Python 3.8+
• Google API key for embeddings
• uv package manager

Installation

1. Clone this repository

2. Create and activate a virtual environment using uv:

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

3. Install dependencies using uv:

uv pip install -r requirements.txt

4. Create a `.env` file with your Google API key:

GOOGLE_API_KEY=your_api_key_here

Running the Server

There are two ways to run the MCP server:

1. Direct Method

To start the MCP server directly:

uv run python server.py

2. Configure for Claude.app

Add to your Claude settings without using any package manager this works for windows:

"mcpServers": {
  "youtube": {
    "command": "C:\\Path\\To\\Your\\Project\\.venv\\Scripts\\python.exe",
    "args": ["C:\\Path\\To\\Your\\Project\\server.py"],
    "env": {
      "GOOGLE_API_KEY": "your_api_key_here"
    }
  }
}

Using Uv package manager this works for windows:

"mcpServers": {
  "youtube": {
    "command": "uv",
    "args": ["--directory", "C:\\Path\\To\\Your\\Project", "run", "server.py"],
    "env": {
      "GOOGLE_API_KEY": "your_api_key_here"
    }
  }
}

Available Tools

The server provides the following tools:

1. `search-youtube`: Search for YouTube videos based on a query

2. `get-transcript`: Get the transcript of a YouTube video

3. `store-video-info`: Store video information and transcript in the vector database

4. `search-transcripts`: Search stored video transcripts using semantic search

Using with MCP Clients

This server can be used with any MCP-compatible client, such as Claude Desktop App. The tools will be automatically discovered and made available to the client.

Example Usage

1. Start the server using one of the methods described above

2. Open Claude Desktop App

3. Look for the hammer icon to verify that the YouTube tools are available

4. You can now use commands like:

Debugging

If you encounter any issues:

1. Make sure your Google API key is correctly set in the `.env` file

2. Check that all dependencies are installed correctly

3. Verify that the server is running and listening for connections

4. Look for any error messages in the server output

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.