home / mcp / youtube uploader mcp server

YouTube Uploader MCP Server

Upload/Schedule videos on Youtube with the help of AI

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "anwerj-youtube-uploader-mcp": {
      "command": "/absolute/path/to/youtube-uploader-mcp-linux-amd64",
      "args": [
        "-client_secret_file",
        "/absolute/path/to/client_secret.json(See Below)"
      ]
    }
  }
}

You can upload videos to YouTube directly from your MCP client with OAuth2 authentication, token management, and multi‑channel support. This MCP lets you authenticate securely, manage access tokens, and push videos to YouTube without relying on YouTube Studio or exposing secrets to external apps.

How to use

Use an MCP client (such as Claude Desktop, Cursor, or VS Code extensions) to trigger video uploads through the YouTube Uploader MCP. You’ll authenticate via OAuth2, which provides access and refresh tokens so you can upload files over multiple sessions. The MCP supports multiple YouTube channels, so you can manage uploads to different channels from a single server.

How to install

Prerequisites: ensure you have a suitable shell (bash/zsh) on macOS/Linux or PowerShell on Windows. You may also need basic tooling for downloading and running binaries.

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/anwerj/youtube-uploader-mcp/master/scripts/install.sh)"

Invoke-WebRequest -UseBasicParsing "https://raw.githubusercontent.com/anwerj/youtube-uploader-mcp/master/scripts/install.ps1" -OutFile "$env:TEMP\install.ps1"; PowerShell -NoProfile -ExecutionPolicy Bypass -File "$env:TEMP\install.ps1"

Additional manual installation steps

If you prefer manual installation, download the appropriate binary from the Releases page for your operating system.

- youtube-uploader-mcp-linux-amd64 - youtube-uploader-mcp-darwin-arm64 - youtube-uploader-mcp-windows-amd64.exe - etc.

You can use the latest versioned tag, e.g., v1.0.0.

chmod +x path/to/youtube-uploader-mcp-<os>-<arch>

Configure MCP (example) to point to the executable and pass the client secret file path when you start the MCP.

{
  "mcpServers": {
    "youtube_uploader_mcp": {
      "command": "/absolute/path/to/youtube-uploader-mcp-<os>-<arch>",
      "args": [
        "-client_secret_file",
        "/absolute/path/to/client_secret.json(See Below)"
      ]
    }
  }
}

Set Up Google OAuth 2.0

To upload to YouTube, you must configure OAuth and obtain a client_secret.json file from the Google Developer Console. Follow the setup steps to create OAuth 2.0 credentials and download the client_secret.json file, then place it at the path you provided in the MCP configuration.

Usage

- main.go serves as the entry point for the CLI interface of the MCP server. - youtube/ contains the YouTube API integration including OAuth flow, video upload, and configuration logic. - tool/ includes command-line utilities for authentication, token management, and uploading pipelines. - hook/ and logn/ provide supporting infrastructure used by the MCP server.

Notes

The YouTube Uploader MCP uses OAuth2 to securely obtain access tokens and refresh tokens. Ensure your client_secret.json is kept private and referenced by your MCP configuration. If you need to upload to multiple channels, set up separate MCP client configurations or manage channel selection within your client setup.

Available tools

oauth_flow

Handles OAuth2 authentication with Google, exchanging authorization grants for access and refresh tokens.

token_management

Manages access and refresh tokens, refreshing them as needed to keep uploads authorized.

video_upload

Uploads video files to YouTube via the API, handling metadata, privacy settings, and scheduling when configured.

schedule_upload

Supports scheduling uploads to run at specific times or across multiple channels as configured.