Youtube MCP

🚀 YouTube MCP

A Model Context Protocol (MCP) server for YouTube integration.

🚀 Quick Start

📦 Installation

Prerequisites - Install uv

• On Mac:

brew install uv

• On Windows:

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

After installation on Windows, add uv to your PATH:

set Path=C:\Users\nntra\.local\bin;%Path%

Claude Desktop Integration

To use this MCP server with Claude Desktop, you need to add it to your Claude Desktop configuration.

1. Open your Claude Desktop configuration file:
   • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
2. Add the following configuration to your mcpServers section (replace /path/to/your/youtube-mcp with the actual path to this project folder):

{
  "mcpServers": {
    "youtube": {
      "command": "/Users/your-username/.local/bin/uv",
      "args": ["--directory", "/path/to/your/youtube-mcp", "run", "main.py"]
    }
  },
  "globalShortcut": ""
}

⚠️ Important Note

Make sure to replace:

• /path/to/your/youtube-mcp with the actual path to where you cloned/downloaded this project
• /Users/your-username/.local/bin/uv with the correct path to your uv installation (on Windows this would typically be C:\Users\your-username\.local\bin\uv.exe)

3. Save the file and restart Claude Desktop

💻 Usage Examples

Basic Usage

Once configured, the YouTube MCP server will be available in Claude Desktop and you can use it to interact with YouTube data and functionality.

🔧 Technical Details

This project uses uv for dependency management. The dependencies are defined in pyproject.toml and the lockfile is uv.lock.

To run the server locally:

uv run main.py