home / mcp / youtube mcp server

YouTube MCP Server

Provides YouTube search, video information, and subtitles via an MCP server for AI assistants.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "hightemp-go_mcp_server_youtube_search": {
      "url": "http://localhost:8889/sse"
    }
  }
}

You can access a compact MCP server that exposes YouTube search capabilities, video details, and subtitles to AI assistants. It lets you perform queries, retrieve structured video data, and fetch subtitles in English or Russian using a simple MCP interface.

How to use

To use the YouTube MCP server with an MCP client, start the server in either Server-Sent Events (sse) mode or stdio mode. In sse mode, you connect to a streaming endpoint to receive results as events. In stdio mode, you run the server as a local process and communicate with it directly.

Available tools include searching YouTube videos, getting detailed video information by ID, and obtaining subtitles for a video. With a client, you can perform a text query, request video details, or fetch subtitles in English or Russian.

Quick start examples show two operation modes below. Adapt the commands to your environment and run them from your shell.

go_mcp_server_youtube_search -t sse -h 0.0.0.0 -p 8889
````

````bash
go_mcp_server_youtube_search -t stdio

How to install

Prerequisites you need before starting: a Go development environment and a compatible MCP client. Ensure you have a Go runtime installed and that you can run binaries from your terminal.

Install and run the server in sse mode by building the binary (if needed) and starting it with the specified host and port.

If you prefer the local stdio mode, run the server directly as a process from your shell.

# Run in sse mode with explicit host/port
go_mcp_server_youtube_search -t sse -h 0.0.0.0 -p 8889

# Run in stdio mode
go_mcp_server_youtube_search -t stdio

Additional notes

The server exposes three core tools and their purposes: youtube_search to search for YouTube videos by text, youtube_get_video_info to retrieve detailed metadata about a video by its ID, and youtube_get_subtitles to obtain subtitles in English or Russian.

Server URL for HTTP connections in sse mode is http://localhost:8889/sse. If you want to run the server locally for a quick test, use the stdio command shown above.

Available tools

youtube_search

Search for YouTube videos using a text query.

youtube_get_video_info

Get detailed information about a video by its ID.

youtube_get_subtitles

Get video subtitles in English or Russian.