yutu

yutu

A fully functional MCP server and CLI for YouTube to automate YouTube operation.

349
Stars
29
Forks
20
Releases

Overview

yutu is a fully functional MCP server and CLI for YouTube to automate your YouTube workflows. It can manipulate almost all YouTube resources, like videos, playlists, channels, comments, captions, and more. As an MCP server, yutu can be used in MCP clients like Claude Desktop, VS Code, or Cursor, which allows you to interact with YouTube resources in a chat-like interface. Before using yutu as an MCP server, you need a valid client_secret.json and youtube.token.json, and you can configure default credential/token paths or override them with environment variables. The README provides a configuration snippet showing how to expose yutu to MCP clients (type: stdio, command: "yutu", args: ["mcp"], env: {"YUTU_CREDENTIAL": "/absolute/path/to/client_secret.json", "YUTU_CACHE_TOKEN": "/absolute/path/to/youtube.token.json"}). The server offers an extensive CLI with commands for activities, authentication, captions, channels, comments, playlists, videos, and more. It relies on Google Cloud OAuth for YouTube API access (YouTube Data API v3, and optionally YouTube Analytics and YouTube Reporting). Installation and distribution options include Docker, Go, Linux, macOS, Windows, and Homebrew, along with an attestation verification workflow for provenance.

Details

Owner
eat-pray-ai
Language
Go
License
Apache License 2.0
Updated
2025-12-07

Features

Comprehensive YouTube resource manipulation

Manipulate videos, playlists, channels, comments, captions, and more through the MCP server.

Built-in MCP server and CLI

Runs as both an MCP server and a command-line interface for YouTube automation.

MCP client compatibility

Interact with YouTube resources via MCP clients such as Claude Desktop, VS Code, and Cursor.

OAuth2 authentication flow

auth subcommand performs OAuth flow and saves tokens to youtube.token.json by default.

Configurable credential management

Default credential and token file paths read from the current directory; override with env vars or flags.

Extensive YouTube command surface

CLI exposes a wide range of commands (activity, auth, caption, channel, comment, playlist, video, etc.).

MCP client configuration snippet

Provides a sample JSON to configure MCP clients with type, command, args, and environment vars.

Cross-platform installation

Install via Docker, Go, Linux, macOS, Windows, or Homebrew, with provenance attestations.

Audience

YouTube creatorsAutomate YouTube tasks and interact with resources via MCP clients like VS Code, Cursor, or Claude.
MCP developersDesign and implement MCP client integrations for automating YouTube workflows.

Tags

MCP serverYouTube automationCLIYouTube resourcesvideosplaylistschannelscommentscaptionsOAuthGoogle APIsVS CodeCursorClaude Desktop