YouTube MCP

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

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: 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)

1. Save the file and restart Claude Desktop

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.

Development

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