YouTube Uploader MCP

AI‑powered YouTube uploader—no CLI, no YouTube Studio, and no secrets ever shared with LLMs or third‑party apps and all free of cost! It includes OAuth2 authentication, token management, and video upload functionality.

Features

• Direct Uploads: Upload videos to YouTube from Claude, Cursor, VS Code, or any other MCP client.

• AI-Assisted Metadata: Automatically generate titles, descriptions, and tags via your MCP client.

• OAuth2 Authentication: Secure local login, multi-channel support, and auto-refreshing.

• Metadata & Settings: Category tags, optional language settings, and explicit metadata control.

• Privacy & Scheduling: Support for public, private, or unlisted statuses, and scheduled publish times.

• Post-Upload Configs (update_video): Add videos to playlists, upload custom thumbnails (<2MB), and attach subtitles.

Related MCP server: YouTube Shorts & Instagram Reels MCP Server

Single Command Installation

For Mac and Linux

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

For Windows(Powershell)

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"

Expected result

This single command will

1. Help in downloading oAuth client secret files, if not downloaded,

2. Download the MCP server,

3. Set minimum required permission to run mcp server,

4. Auto update Cluade Desktop config with youtube-uploader-mcp server and

5. At last print exact MCP config for any other clients VS Code/Cursor/AnythingLLM etc.

Demo

Setup and Demo Video

Manual Installation

Please check Single Command Installation, proceed if you prefer manual installation.

Visit the Releases page and download the appropriate binary 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.

2. Make it Executable (Linux/macOS)

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

3. Configure MCP (e.g., in Claude Desktop or Cursor)

{
  "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)"
      ]
    }
  }
}

4. Set Up Google OAuth 2.0

To upload to YouTube, you must configure OAuth and get a client_secret.json file from the Google Developer Console.

➡️ Follow the guide in youtube_oauth2_setup.md for a step-by-step walkthrough.

Usage & Tool Orchestration

The MCP server registers the following tools:

1. authenticate: Generates the OAuth2 URL for authentication.

2. accesstoken: Exchanges the code for user credentials and channel info.

3. channels: Retrieves authenticated channels.

4. refreshtoken: Force-refreshes tokens.

5. upload_video: Uploads the video file and configures main details (title, description, tags, category, optional language, status, kids' flags, scheduled publish).

6. update_video: Decoupled tool that manages post-upload configurations: adds the video to a playlist, uploads a custom thumbnail (must be <2MB), and attaches subtitle/caption tracks.

Contributing

See CONTRIBUTING.md to contribute.