PluginBench
MCP Server
Active
Apache-2.0

yutu MCP Server

io.github.eat-pray-ai/yutu

AI-powered toolkit that automates YouTube workflows—uploading, optimizing, and managing videos at scale.

RepositoryRegistry
How to choose

What this kind of tool is for

  • Chain multi-step workflows across the other tools in this directory.
  • Run a scheduled or triggered job instead of retyping the same request.
  • Have your agent watch a feed, queue, or repo and act on new items.

How to compare servers like this

Trigger model:
Understand what starts the automation — a command, a schedule, or an event — before relying on it.
Blast radius:
Prefer tools that hand you a review point before an irreversible action runs.
Chaining cost:
Each chained step adds a failure point; keep critical paths on the fewest tools.
Maintenance signal:
Automations break quietly; a maintained tool is the difference between repair and rediscovery.

This page carries your copy-paste config: pick your MCP client in the install section on this page and use the copy button.

What is the yutu MCP server?

The yutu MCP server is a CLI, MCP server, and AI agent for YouTube that automates your entire YouTube workflow from uploading and optimizing videos to managing comments, playlists, and channel branding. It integrates with Claude and other AI agents via the Model Context Protocol to enable hands-off YouTube channel growth.

yutu automates YouTube content management tasks including video uploads, metadata optimization, comment management, playlist creation, caption handling, and channel analytics. Use it to reduce manual effort in running a YouTube channel while improving views, click-through rates, and audience engagement through AI-driven optimization and strategy.

How to install yutu

Copy-paste configuration for popular MCP clients.

transport: stdio
Config generated by PluginBench — verify against the source before use.
Environment / auth
  • YUTU_CREDENTIAL
    required
    secret

    GCP project credential for yutu, Base64 encoded JSON or path to JSON file

  • YUTU_CACHE_TOKEN
    required
    secret

    YouTube authentication token, Base64 encoded JSON or path to JSON file

  • YUTU_LOG_LEVEL

    Log level

~/Library/Application Support/Claude/claude_desktop_config.json
JSON config
{
  "mcpServers": {
    "yutu": {
      "command": "npx",
      "args": [
        "-y",
        "@eat-pray-ai/yutu",
        "mcp",
        "--mode",
        "stdio"
      ],
      "env": {
        "YUTU_CREDENTIAL": "<YOUR_YUTU_CREDENTIAL>",
        "YUTU_CACHE_TOKEN": "<YOUR_YUTU_CACHE_TOKEN>",
        "YUTU_LOG_LEVEL": "<YOUR_YUTU_LOG_LEVEL>"
      }
    }
  }
}

Tools & capabilities

Tools this server exposes to the agent.

  • Video Upload — Upload videos to YouTube with metadata and optimization
  • Video Search & List — Search and list videos from your channel
  • Playlist Management — Create and manage YouTube playlists
  • Comment Management — Retrieve, post, and manage comments on videos
  • Caption Management — Add, update, and manage video captions
  • Metadata Optimization — Update video titles, descriptions, tags, and thumbnails
  • Channel Analytics — Retrieve YouTube Analytics and Reporting data
  • Subscription Management — Manage channel subscriptions
  • Watermark Management — Set and manage channel watermarks
  • Channel Sections — Manage channel sections and organization
  • Google Search — Search the web for research and optimization insights

Use cases

  • Automate bulk video uploads with optimized metadata and SEO tags
  • Generate and optimize video titles, descriptions, and thumbnails using AI analysis
  • Manage and respond to comments at scale across your entire channel
  • Create and organize playlists programmatically based on content themes
  • Retrieve and analyze YouTube analytics to inform content strategy
  • Set up multi-agent workflows for end-to-end channel growth automation

yutu MCP server FAQ

What is yutu?

yutu is an AI-powered toolkit that automates YouTube workflows. It works as a CLI tool, MCP server for Claude/Cursor, and autonomous agent, handling video uploads, metadata optimization, comment management, analytics, and more.

Is yutu free?

yutu is open-source (Apache 2.0 license) and free to use. You only need a Google Cloud Platform account with YouTube Data API enabled.

How do I install yutu in Cursor or Claude?

Install yutu via npm (`npm i -g @eat-pray-ai/yutu`), then add it as an MCP server in Cursor or Claude using the provided install badges or by manually configuring it with your YouTube credentials.

What authentication is required?

You need a Google Cloud Platform project with YouTube Data API v3 enabled, OAuth 2.0 credentials (client_secret.json), and a valid YouTube token (youtube.token.json). Run `yutu auth` to set this up.

Can yutu delete content?

Yes, yutu has a 'Destroyer' agent that can delete videos, playlists, comments, captions, and other content, but these operations require explicit confirmation for safety.

Does yutu support AI agents?

Yes, yutu includes a multi-agent system with Orchestrator, Retrieval, Modifier, and Destroyer agents. Currently it supports Google Gemini models and requires setting YUTU_ADVANCED_MODEL and YUTU_LITE_MODEL environment variables.

README (reference)

Source of truth, from the repository.

Yutu

yutu

Static Badge Go Report Card GitHub License Go Reference Go Coverage

GitHub Repo stars GitHub Downloads GitHub Actions build Status GitHub Actions CodeQL Status GitHub Actions test Status LINUX DO

GitHub Release Homebrew Formula Version WinGet Package Version npm Version

YouTube CLI, MCP server, Skill and Agent - AI-powered toolkit that grows YouTube channel on autopilot | Product
Hunt

yutu is a CLI, MCP server, and AI agent for YouTube that automates your entire YouTube workflow — from uploading and optimizing videos to managing comments, playlists, and channel branding — so you can get more views, higher click-through rates, and stronger audience engagement with less manual effort. 中文文档

mcp demo

Table of Contents

Prerequisites

An account on Google Cloud Platform is required. Set up the following:

  1. Create a GCP Project and enable these APIs under APIs & Services -> Enable APIs and services:

  2. Create OAuth credentials:

    • Go to APIs & Services -> OAuth consent screen, create a consent screen with yourself as a test user
    • Go to Credentials -> Create Credentials -> OAuth Client ID, select Desktop app
    • Download the credential file and save it as client_secret.json, it should look like
    {
      "installed": {
        "client_id": "11181119.apps.googleusercontent.com",
        "project_id": "yutu-11181119",
        "auth_uri": "https://accounts.google.com/o/oauth2/auth",
        "token_uri": "https://oauth2.googleapis.com/token",
        "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
        "client_secret": "XXXXXXXXXXXXXXXX",
        "redirect_uris": [
          "http://localhost"
        ]
      }
    }
    
  3. Authenticate:

    yutu auth --credential client_secret.json
    

    A browser window will open for you to grant YouTube access. After granting permission, a token is saved to youtube.token.json.

    {
      "access_token": "ya29.XXXXXXXXX",
      "token_type": "Bearer",
      "refresh_token": "1//XXXXXXXXXX",
      "expiry": "2024-05-26T18:49:56.1911165+08:00",
      "expires_in": 3599
    }
    

By default, yutu will read client_secret.json and youtube.token.json from the current directory, --credential/-c and --cacheToken/-t flags are available only in auth subcommand. To modify the default path in all subcommands, set these environment variables.

Global Environment Variables

VariableDescriptionDefault
YUTU_CREDENTIALPath, Base64, or JSON of OAuth client secretclient_secret.json
YUTU_CACHE_TOKENPath, Base64, or JSON of cached OAuth tokenyoutube.token.json
YUTU_ROOTRoot directory for file resolutionCurrent working directory
YUTU_LOG_LEVELLog level: DEBUG, INFO, WARN, ERRORINFO

Installation

You can download yutu from releases page directly, or use the following methods as you prefer.

<details> <summary>GitHub Actions</summary>

There are two actions available for yutu, one is for general purpose and the other is for uploading video to YouTube. Refer to youtube-action and youtube-uploader for more information.

</details> <details> <summary>Node.js</summary>
❯ npm i -g @eat-pray-ai/yutu
</details> <details> <summary>Docker</summary>
❯ docker pull ghcr.io/eat-pray-ai/yutu:latest
❯ docker run --rm ghcr.io/eat-pray-ai/yutu:latest
# make sure client_secret.json is in the current directory
❯ docker run --rm -it -u $(id -u):$(id -g) -v $(pwd):/app -p 8216:8216 ghcr.io/eat-pray-ai/yutu:latest
</details> <details> <summary>Gopher</summary>
❯ go install github.com/eat-pray-ai/yutu@latest
</details> <details> <summary>Linux</summary>
❯ curl -sSfL https://raw.githubusercontent.com/eat-pray-ai/yutu/main/scripts/install.sh | bash
</details> <details> <summary>macOS</summary>

Install yutu using Homebrew🍺(recommended), or run the shell script.

❯ brew install yutu

# or
❯ curl -sSfL https://raw.githubusercontent.com/eat-pray-ai/yutu/main/scripts/install.sh | bash
</details> <details> <summary>Windows</summary>
❯ winget install yutu
</details> <details> <summary>Verifying Installation</summary>

Verify the integrity and provenance of yutu using its associated cryptographically signed attestations.

# Docker
❯ gh attestation verify oci://ghcr.io/eat-pray-ai/yutu:latest --repo eat-pray-ai/yutu

# Linux and macOS(if installed using shell script)
❯ gh attestation verify $(which yutu) --repo eat-pray-ai/yutu

# Windows
❯ gh attestation verify $(where.exe yutu.exe) --repo eat-pray-ai/yutu
</details>

Agent

yutu provides an agent mode to automate YouTube workflows. The system uses a multi-agent architecture where a central orchestrator delegates tasks to specialized agents:

AgentRoleCapabilities
OrchestratorCoordinates the entire workflow, plans strategy, and delegates to sub-agentsYouTube growth strategy, SEO optimization, task routing
RetrievalGathers data from YouTube and the web (read-only)List/search videos, channels, playlists, comments, captions, subscriptions, members, and more; Google Search
ModifierCreates and updates YouTube contentUpload videos, create playlists, update metadata, post comments, set thumbnails, manage captions and watermarks
DestroyerHandles destructive operations with extra cautionDelete videos, playlists, comments, captions, subscriptions, channel sections, and watermarks

Currently, the agent mode is under active development, only supports Google's Gemini models with the following environment variables set:

❯ export YUTU_ADVANCED_MODEL=google:gemini-3.1-pro-preview
❯ export YUTU_LITE_MODEL=google:gemini-3-flash-preview
❯ export YUTU_LLM_API_KEY=your_gemini_api_key
// Optional settings
❯ export GOOGLE_GEMINI_BASE_URL=https://generativelanguage.googleapis.com/
❯ export YUTU_AGENT_INSTRUCTION=Your custom instruction here

YUTU_ADVANCED_MODEL is used by the orchestrator agent, while YUTU_LITE_MODEL is used by all other agents. Both use the provider:modelName format (only google is supported). If only one is set, the other defaults to the same value.

Agent Environment Variables

VariableDescriptionRequired
YUTU_ADVANCED_MODELModel for orchestrator agent (format: provider:modelName)At least one of YUTU_ADVANCED_MODEL or YUTU_LITE_MODEL
YUTU_LITE_MODELModel for sub-agents (format: provider:modelName)At least one of YUTU_ADVANCED_MODEL or YUTU_LITE_MODEL
YUTU_LLM_API_KEYAPI key for the model providerYes
GOOGLE_GEMINI_BASE_URLBase URL for Gemini APINo
YUTU_AGENT_INSTRUCTIONCustom instruction for orchestrator agentNo
YUTU_RETRIEVAL_INSTRUCTIONCustom instruction for retrieval agentNo
YUTU_MODIFIER_INSTRUCTIONCustom instruction for modifier agentNo
YUTU_DESTROYER_INSTRUCTIONCustom instruction for destroyer agentNo

Then run the following command for detail usage:

❯ yutu agent --help
❯ yutu agent --args "help"
# console mode
❯ yutu agent --args "console"
# web mode with three sub-launchers: api, a2a and webui
❯ yutu agent --args "web api a2a webui"

MCP Server

Before using yutu as an MCP server, make sure yutu is installed(see Installation section), and you have a valid client_secret.json and youtube.token.json files(refer to Prerequisites section).

You can add yutu as an MCP server in VS Code or Cursor by clicking corresponding badge, or use the CLI commands below for your preferred tool.

Install in VS Code Install in Cursor

<details> <summary>Claude Code</summary>
# Stdio mode
❯ claude mcp add -e YUTU_CREDENTIAL=/absolute/path/to/client_secret.json \
  -e YUTU_CACHE_TOKEN=/absolute/path/to/youtube.token.json \
  yutu -- yutu mcp

# HTTP mode (start the server first: yutu mcp --mode http --auth)
❯ claude mcp add --transport http \
  --client-id YOUR_CLIENT_ID.apps.googleusercontent.com \
  --client-secret \
  yutu http://localhost:8216/mcp
</details> <details> <summary>Codex</summary>
# Stdio mode
❯ codex mcp add --env YUTU_CREDENTIAL=/absolute/path/to/client_secret.json \
  --env YUTU_CACHE_TOKEN=/absolute/path/to/youtube.token.json \
  yutu -- yutu mcp

# HTTP mode (start the server first: yutu mcp --mode http --auth)
❯ codex mcp add --url http://localhost:8216/mcp \
  --oauth-client-id YOUR_CLIENT_ID.apps.googleusercontent.com \
  yutu
</details> <details> <summary>Manual Configuration (VS Code, Cursor, OpenCode, etc.)</summary>

Add the following to your MCP settings. Remember to replace the values of YUTU_CREDENTIAL and YUTU_CACHE_TOKEN with correct paths on your local machine.

{
  "yutu": {
    "type": "stdio",
    "command": "yutu",
    "args": [
      "mcp"
    ],
    "env": {
      "YUTU_CREDENTIAL": "/absolute/path/to/client_secret.json",
      "YUTU_CACHE_TOKEN": "/absolute/path/to/youtube.token.json"
    }
  }
}
</details>

Skills

yutu provides a unified skill that extends AI agents with YouTube domain knowledge, common workflows, and SEO best practices — covering videos, playlists, comments, channels, captions, subscriptions, and more.

❯ npx skills add https://github.com/eat-pray-ai/yutu/tree/main/skills/youtube

See skills/youtube/SKILL.md for the full list of supported operations.

Usage

❯ yutu        
yutu is a CLI, MCP server, and AI agent for YouTube that can automate almost all YouTube workflows.

Environment variables:
  YUTU_CREDENTIAL    Path/Base64/JSON of OAuth client secret (default: client_secret.json)
  YUTU_CACHE_TOKEN   Path/Base64/JSON of cached OAuth token (default: youtube.token.json)
  YUTU_ROOT          Root directory for file resolution (default: current working directory)
  YUTU_LOG_LEVEL     Log level: DEBUG, INFO, WARN, ERROR (default: INFO)

Usage:
  yutu [flags]
  yutu [command]

Available Commands:
  activity               Manage activities on YouTube
  agent                  Start an agent to automate YouTube workflows
  auth                   Authenticate with YouTube APIs
  caption                Manage YouTube video captions
  channel                Manage YouTube channels
  channelBanner          Manage YouTube channel banners
  channelSection         Manage YouTube channel sections
  comment                Manage YouTube comments
  commentThread          Manage YouTube comment threads
  completion             Generate the autocompletion script for the specified shell
  help                   Help about any command
  i18nLanguage           Manage YouTube i18n languages
  i18nRegion             Manage YouTube i18n regions
  mcp                    Start MCP server
  member                 Manage YouTube channel members
  membershipsLevel       Manage YouTube memberships levels
  playlist               Manage YouTube playlists
  playlistImage          Manage YouTube playlist images
  playlistItem           Manage YouTube playlist items
  search                 Manage YouTube search
  subscription           Manage YouTube subscriptions
  superChatEvent         Manage YouTube Super Chat events
  thirdPartyLink         Manage YouTube third-party links
  thumbnail              Manage YouTube video thumbnails
  version                Show the version of yutu
  video                  Manage YouTube videos
  videoAbuseReportReason Manage YouTube video abuse report reasons
  videoCategory          Manage YouTube video categories
  watermark              Manage YouTube watermarks

Flags:
  -h, --help   help for yutu

Use "yutu [command] --help" for more information about a command.

Features

Please refer to FEATURES.md for more information.

Contributing

Please refer to CONTRIBUTING.md for more information.

Star History

Star History Chart

Related MCP servers

MCP server for Reolink cameras: snapshots, device state, AI detection, PTZ, and deterrence controls

2
Python
MIT
View repository →

Real-time fuel prices, alerts, and cheapest gas stations across 38+ countries.

View repository →

Brazilian tools for agents: Pix, CEP, CNPJ, BCB rates + web capture and PDF. Pay per call.

1
JavaScript
MIT
View repository →
EMEmboss logo

Emboss

Active

Turn any PDF form into a fillable one, fill it from data or documents, verify it, and fax it.

0
Shell
MIT
View repository →

Find APIs and MCP servers for AI agents: auth, free tier, MCP endpoint, docs, last-checked date.

1
Python
View repository →

Protect media from AI training, detect AI-generated content, and find stolen work.

0
TypeScript
MIT
View repository →