youtube-automation

io.github.eat-pray-aiPublished by GitHub account eat-pray-aiv0.11.1Updated Nov 15, 2026

CLI, MCP server, and AI Agent to automate YouTube workflows

Overview

youtube-automation's local MCP server; no sign-in required; STDIO; 74 tools.

No AI overview yet: these facts come from the registry entry and the server itself.

Installation

In SourceWeft

  1. Open youtube-automation in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

[Yutu]

yutu

[Static Badge] [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]

yutu is a CLI, MCP server, and AI Agent to automate YouTube workflows — from uploading and optimizing videos to managing comments, playlists, and channel branding — and provides a skill for AI Agents, 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
    json
    {  "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:

    bash
    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.

    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

If you're using an AI Agent, copy and paste the following prompt to finish the installation:

plaintext
Install and configure yutu by following https://raw.githubusercontent.com/eat-pray-ai/yutu/main/internal/tools/skillgen/setup.md

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

GitHub Actions

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.

Node.js
shell
❯ npm i -g @eat-pray-ai/yutu
Docker
shell
# GitHub Container Registry (GHCR)❯ docker pull ghcr.io/eat-pray-ai/yutu:latest# or Docker Hub❯ docker pull eatprayai/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
Gopher
shell
❯ go install github.com/eat-pray-ai/yutu@latest
Linux
shell
❯ curl -sSfL https://raw.githubusercontent.com/eat-pray-ai/yutu/main/scripts/install.sh | bash
macOS

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

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

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

shell
# Docker❯ gh attestation verify oci://ghcr.io/eat-pray-ai/yutu:latest --repo eat-pray-ai/yutu❯ gh attestation verify oci://docker.io/eatprayai/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

Agent

yutu provides an Agent mode (Miffy) to automate YouTube workflows. The Agent can retrieve, create, update, and delete YouTube content, with built-in YouTube growth strategy and SEO expertise.

shell
# Gemini(compatible) (default)❯ yutu agent --provider google --model gemini-3.8-flash --api-key "YOUR_KEY"❯ yutu agent --provider google --model gemini-3.8-flash --api-key "YOUR_KEY" --base-url "https://custom.endpoint.com/"# OpenAI(compatible) (OpenAI, DeepSeek, Ollama, vLLM, etc.)❯ yutu agent --provider openai --model gpt-5.6-terra --api-key "YOUR_KEY"❯ yutu agent --provider openai --model deepseek-flash --api-key "YOUR_KEY" --base-url "https://api.deepseek.com/"# web mode with sub-launchers❯ yutu agent --args "web api a2a webui" --api-key "YOUR_KEY"# show available launcher args❯ yutu agent --args ""

Agent Flags

FlagDescriptionDefault
-a, --argsLauncher arguments as a single stringconsole
-p, --providerLLM provider: google for Gemini(compatible), openai for OpenAI(compatible)google
-m, --modelModel namegemini-3.8-flash
--api-keyAPI key for the model provider
--base-urlBase URL for the model provider's API endpoint
-i, --instructionOverride the built-in Agent instructionINSTRUCTION.md

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).

Setup yutu MCP for one or more selected AI Agents:

shell
❯ yutu mcp setup --agents claude,opencode,pi,codex \  --credential /absolute/path/to/client_secret.json \  --cacheToken /absolute/path/to/youtube.token.json

--agents is required. Credential/token flags accept Path/Base64/JSON; omitted flags use the corresponding environment variable or default file path. Relative paths are converted to absolute paths. Prefer file paths to avoid copying inline secrets into Agent settings.

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.

shell
❯ npx skills add eat-pray-ai/yutu --skill youtube-automation

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

Usage

shell
❯ yutuyutu is a CLI, MCP server, and AI Agent that automates your YouTube workflows from the terminal or any AI Agent.
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:  abuseReport            Manage YouTube abuse reports  activity               Manage YouTube activities  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  liveBroadcast          Manage YouTube live broadcasts  liveChatBan            Manage YouTube live chat bans  liveChatMessage        Manage YouTube live chat messages  liveChatModerator      Manage YouTube live chat moderators  liveStream             Manage YouTube live streams  mcp                    Start MCP server  member                 Manage YouTube channel members  membershipsLevel       Manage YouTube membership 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.

Sponsor

If yutu saves you time, a ⭐ star on GitHub goes a long way and helps others discover the project.

You can also support its development with a donation (Alipay / WeChat) at yutu.ifor.dev. Thank you! 💖

Contributing

Please refer to CONTRIBUTING.md for more information.

Source: README.md at commit 59095f7

Tools

74

abuseReport-insert

Create an abuse report

Create an abuse report. Use this tool to report abusive content on YouTube such as spam, harassment, or violent content.

Parameterspartsoutputsubject_idrequiredabuse_typesrequireddescriptionsubject_urlsubject_type_idrequiredrelated_entity_id

activity-list

List activities

List activities. Use this tool to list activities such as uploads, likes, and favorites.

Parametersforpartsoutputchannel_idmax_resultsregion_codepublished_afterpublished_before

caption-delete

Delete captions

Delete captions. Use this tool to delete captions of a video by IDs.

Parametersidsrequiredon_behalf_ofon_behalf_of_content_owner

caption-download

Download a caption

Download a caption. Use this tool to download a caption from a video.

Parametersidsrequiredfilerequiredtfmttlangon_behalf_ofon_behalf_of_content_owner

caption-insert

Upload a caption

Upload a caption. Use this tool to upload a caption to a video.

Parametersfilerequirednameis_ccoutputis_draftis_largelanguagevideo_idrequiredon_behalf_ofis_auto_syncedis_easy_readeron_behalf_of_content_owner

caption-list

List captions

List captions. Use this tool to list captions of a video.

Parametersidspartsoutputvideo_idon_behalf_ofon_behalf_of_content_owner

caption-update

Update a caption

Update a caption. Use this tool to update a caption.

Parametersfilenameis_ccoutputis_draftis_largelanguagevideo_idrequiredtrack_kindon_behalf_ofis_auto_syncedis_easy_reader+2 more

channel-list

List channels

List channels. Use this tool to list channels.

Parametershlforidspartsoutputfor_handlecategory_idmax_resultsfor_usernameon_behalf_of_content_owner

channel-update

Update a channel

Update a channel. Use this tool to update a channel.

Parametersidsrequiredtitleoutputcountrykeywordsdescriptiondefault_language

channelBanner-insert

Upload a channel banner

Upload a channel banner. Use this tool to upload a channel banner.

Parametersfilerequiredoutputchannel_idrequiredon_behalf_of_content_owneron_behalf_of_content_owner_channel

channelSection-delete

Delete channel sections

Delete channel sections. Use this tool to delete channel sections by IDs.

Parametersidsrequiredon_behalf_of_content_owner

channelSection-list

List channel sections

List channel sections. Use this tool to list channel sections.

Parametershlidsminepartsoutputchannel_idon_behalf_of_content_owner

comment-delete

Delete comments

Delete comments. Use this tool to delete comments by IDs.

Parametersidsrequired

comment-insert

Create a comment

Create a comment. Use this tool to create a comment on a video.

Parametersoutputcan_ratevideo_idparent_idrequiredchannel_idtext_originalrequiredauthor_channel_id

comment-list

List comments

List comments. Use this tool to list comments by IDs.

Parametersidspartsoutputparent_idmax_resultstext_format

comment-markAsSpam

Mark comments as spam

Mark comments as spam. Use this tool to mark comments as spam.

Parametersidsrequiredoutput

comment-setModerationStatus

Set comment moderation status

Set comment moderation status. Use this tool to set comment moderation status.

Parametersidsrequiredoutputban_authormoderation_statusrequired

comment-update

Update a comment

Update a comment. Use this tool to update a comment.

Parametersidsrequiredoutputcan_ratetext_originalviewer_rating

commentThread-insert

Create a comment thread

Create a comment thread. Use this tool to create a comment thread.

Parametersoutputvideo_idrequiredchannel_idrequiredtext_originalrequiredauthor_channel_id

commentThread-list

List comment threads

List comment threads. Use this tool to list comment threads.

Parametersidsorderpartsoutputvideo_idchannel_idmax_resultstext_formatsearch_termsmoderation_statusall_threads_related_to_channel_id

liveBroadcast-bind

Bind a live broadcast to a stream

Bind a live broadcast to a stream. Use this tool to bind or unbind a live stream to/from a live broadcast.

Parametersidsrequiredpartsoutputstream_idon_behalf_of_content_owneron_behalf_of_content_owner_channel

liveBroadcast-delete

Delete live broadcasts

Delete live broadcasts. Use this tool to delete live broadcasts by their IDs.

Parametersidsrequiredon_behalf_of_content_owneron_behalf_of_content_owner_channel

liveBroadcast-insert

Create a live broadcast

Create a live broadcast. Use this tool to create a live broadcast for the authenticated user.

Parameterspartstitlerequiredoutputdescriptionprivacy_statusscheduled_end_timescheduled_start_timerequiredon_behalf_of_content_owneron_behalf_of_content_owner_channel

liveBroadcast-insertCuepoint

Insert a cuepoint into a live broadcast

Insert a cuepoint into a live broadcast. Use this tool to insert an ad break cuepoint into a currently live broadcast.

Parametersidsrequiredoutputcue_typecue_walltime_mscue_duration_secscue_insertion_offset_mson_behalf_of_content_owneron_behalf_of_content_owner_channel

liveBroadcast-list

List live broadcasts

List live broadcasts. Use this tool to list live broadcasts for the authenticated user.

Parametersidsminepartsoutputmax_resultsbroadcast_typebroadcast_statuson_behalf_of_content_owneron_behalf_of_content_owner_channel

liveBroadcast-transition

Transition a live broadcast

Transition a live broadcast. Use this tool to change the status of a live broadcast (e.g., go live, end broadcast).

Parametersidsrequiredpartsoutputbroadcast_statusrequiredon_behalf_of_content_owneron_behalf_of_content_owner_channel

liveBroadcast-update

Update a live broadcast

Update a live broadcast. Use this tool to update an existing live broadcast's settings.

Parametersidsrequiredtitleoutputdescriptionprivacy_statusscheduled_end_timescheduled_start_timeon_behalf_of_content_owneron_behalf_of_content_owner_channel

liveChatBan-delete

Delete live chat bans

Delete live chat bans. Use this tool to unban users from a live chat by ban IDs.

Parametersidsrequired

liveChatBan-insert

Create a live chat ban

Create a live chat ban. Use this tool to ban a user from a live chat.

Parameterspartsoutputban_typerequiredlive_chat_idrequiredban_duration_secondsbanned_user_channel_idrequired

liveChatMessage-delete

Delete live chat messages

Delete live chat messages. Use this tool to remove messages from a live chat by their IDs.

Parametersidsrequired

liveChatMessage-insert

Send a live chat message

Send a live chat message. Use this tool to post a text message to a live chat.

Parameterspartsoutputlive_chat_idrequiredmessage_textrequired

liveChatMessage-list

List live chat messages

List live chat messages. Use this tool to list messages in a live chat.

Parametershlpartsoutputmax_resultslive_chat_idrequired

liveChatMessage-transition

Transition a live chat message

Transition a durable live chat event. Use this tool to change the status of a live chat message (e.g., close a poll).

Parametersidsrequiredoutputstatusrequired

liveChatModerator-delete

Delete live chat moderators

Delete live chat moderators. Use this tool to remove moderators from a live chat by their IDs.

Parametersidsrequired

liveChatModerator-insert

Add a live chat moderator

Add a live chat moderator. Use this tool to add a moderator to a live chat.

Parameterspartsoutputlive_chat_idrequiredmoderator_channel_idrequired

liveChatModerator-list

List live chat moderators

List live chat moderators. Use this tool to list moderators for a live chat.

Parameterspartsoutputmax_resultslive_chat_idrequired

liveStream-delete

Delete live streams

Delete live streams. Use this tool to delete live streams by their IDs.

Parametersidsrequiredon_behalf_of_content_owneron_behalf_of_content_owner_channel

liveStream-insert

Create a live stream

Create a live stream. Use this tool to create a live stream.

Parameterspartstitlerequiredoutputframe_rateresolutionrequireddescriptioningestion_typerequiredon_behalf_of_content_owneron_behalf_of_content_owner_channel

liveStream-list

List live streams

List live streams. Use this tool to list live streams for the authenticated user.

Parametersidsminepartsoutputmax_resultson_behalf_of_content_owneron_behalf_of_content_owner_channel

liveStream-update

Update a live stream

Update a live stream. Use this tool to update an existing live stream's settings.

Parametersidsrequiredtitleoutputframe_rateresolutiondescriptioningestion_typeon_behalf_of_content_owneron_behalf_of_content_owner_channel

member-list

List channel members

List channel members. Use this tool to list information about channel members.

Parametersmodepartsoutputmax_resultsmember_channel_idhas_access_to_level

membershipsLevel-list

List membership levels

List membership levels. Use this tool to list membership levels.

Parameterspartsoutput

playlist-delete

Delete playlists

Delete playlists. Use this tool to delete playlists by IDs.

Parametersidsrequiredon_behalf_of_content_owner

playlist-insert

Create a playlist

Create a playlist. Use this tool to create a playlist.

Parameterstagstitlerequiredoutputprivacyrequiredlanguagechannel_idrequireddescription

playlist-list

List playlists

List playlists. Use this tool to list playlists.

Parametershlidsminepartsoutputchannel_idmax_resultson_behalf_of_content_owneron_behalf_of_content_owner_channel

playlist-update

Update a playlist

Update a playlist. Use this tool to update a playlist.

Parametersidsrequiredtagstitleoutputprivacylanguagedescription

playlistImage-delete

Delete playlist images

Delete playlist images. Use this tool to delete playlist images by IDs.

Parametersidsrequiredon_behalf_of_content_owner

playlistImage-insert

Upload a playlist image

Upload a playlist image. Use this tool to upload a playlist image.

Parametersfilerequiredtypewidthheightoutputplaylist_idrequiredon_behalf_of_content_owneron_behalf_of_content_owner_channel

playlistImage-list

List playlist images

List playlist images. Use this tool to list playlist images.

Parameterspartsoutputparentmax_resultson_behalf_of_content_owneron_behalf_of_content_owner_channel

playlistImage-update

Update a playlist image

Update a playlist image. Use this tool to update a playlist image.

Parameterstypewidthheightoutputplaylist_idrequiredon_behalf_of_content_owneron_behalf_of_content_owner_channel

playlistItem-delete

Delete playlist items

Delete playlist items. Use this tool to delete playlist items by IDs.

Parametersidsrequiredon_behalf_of_content_owner

playlistItem-insert

Add a playlist item

Add a playlist item. Use this tool to add a playlist item to a playlist.

Parameterskindrequiredtitleoutputprivacychannel_idrequiredk_video_iddescriptionplaylist_idrequiredk_channel_idk_playlist_idon_behalf_of_content_owner

playlistItem-list

List playlist items

List playlist items. Use this tool to list playlist items.

Parametersidspartsoutputvideo_idmax_resultsplaylist_idon_behalf_of_content_owner

playlistItem-update

Update a playlist item

Update a playlist item. Use this tool to update a playlist item.

Parametersidsrequiredtitleoutputprivacydescriptionon_behalf_of_content_owner

search-list

Search resources

Search resources. Use this tool to search for videos, channels, playlists, and other resources.

Parametersqfororderpartstypesoutputlocationtopic_idchannel_idevent_typevideo_typemax_results+17 more

subscription-delete

Delete subscriptions

Delete subscriptions. Use this tool to delete subscriptions by IDs.

Parametersidsrequired

subscription-insert

Subscribe to a channel

Subscribe to a channel. Use this tool to subscribe to a YouTube channel.

Parameterstitleoutputchannel_idrequireddescriptionsubscriber_channel_idrequired

subscription-list

List subscriptions

List subscriptions. Use this tool to list subscriptions.

Parametersforidsorderpartsoutputchannel_idmax_resultsfor_channel_idon_behalf_of_content_owneron_behalf_of_content_owner_channel

superChatEvent-list

List Super Chat events

List Super Chat events. Use this tool to list Super Chat events.

Parametershlpartsoutputmax_results

thumbnail-set

Set a thumbnail for a video

Set a thumbnail for a video. Use this tool to set a thumbnail for a video.

Parametersfilerequiredoutputvideo_idrequired

video-delete

Delete videos

Delete videos. Use this tool to delete videos by IDs.

Parametersidsrequired

video-getRating

Get video ratings

Get video ratings. Use this tool to get video ratings by IDs.

Parametersidsrequiredoutputon_behalf_of_content_owner

video-insert

Upload a video

Upload a video. Use this tool to upload a video.

Parametersfilerequiredtagstitleoutputlicenseprivacyrequiredfor_kidslanguagestabilizethumbnailchannel_idembeddable+11 more

video-list

List videos

List videos. Use this tool to list videos.

Parametershlidschartpartslocaleoutputratingmax_widthmax_heightcategory_idmax_resultsregion_code+1 more

video-rate

Rate a video

Rate a video. Use this tool to rate a video.

Parametersidsrequiredratingrequired

video-reportAbuse

Report abuse on a video

Report abuse on a video. Use this tool to report abuse on a video.

Parametersidsrequiredcommentslanguagereason_idrequiredsecondary_reason_idon_behalf_of_content_owner

video-update

Update a video

Update a video. Use this tool to update a video.

Parametersidsrequiredtagstitleoutputlicenseprivacylanguagethumbnailembeddablepublish_atcategory_iddescription+3 more

videoAbuseReportReason-list

List video abuse report reasons

List video abuse report reasons. Use this tool to list available abuse report reasons.

Parametershlpartsoutput

watermark-set

Set a channel watermark

Set a channel watermark. Use this tool to set a channel watermark.

Parametersfilerequiredoffset_mschannel_idrequiredduration_msoffset_typein_video_positionon_behalf_of_content_owner

watermark-unset

Unset a channel watermark

Unset a channel watermark. Use this tool to unset a channel watermark.

Parameterschannel_idrequired

Version history

3
  1. v0.11.1LatestNov 15, 2026
  2. v0.11.0Oct 15, 2026
  3. v0.10.11-dev3Sep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts