
yutu
CLI and MCP server for YouTube — upload, optimize, and manage videos, playlists, comments, and channel branding.
Add to your client
Copy the config for your MCP client and paste it into its config file.
npm i -g @eat-pray-ai/yutuPaste into ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"yutu": {
"command": "yutu",
"args": [
"mcp"
],
"env": {
"YUTU_CREDENTIAL": "/absolute/path/to/client_secret.json",
"YUTU_CACHE_TOKEN": "/absolute/path/to/youtube.token.json"
}
}
}
}Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf
Before you start
- A Google Cloud Platform account with a GCP project
- YouTube Data API v3 enabled (Required); YouTube Analytics API and YouTube Reporting API optional
- OAuth Client ID credentials (Desktop app) saved as client_secret.json
- A cached OAuth token (youtube.token.json) generated by running `yutu auth --credential client_secret.json`
- yutu installed (via npm, Homebrew, WinGet, go install, Docker, or release binary)
About yutu
yutu is an open-source (Apache-2.0) Go toolkit that acts as a CLI, MCP server, and AI agent for YouTube. Running yutu mcp starts an MCP server that exposes almost all YouTube resources — videos, playlists, playlist items, playlist images, comments, comment threads, captions, channels, channel banners, channel sections, subscriptions, members, memberships levels, thumbnails, watermarks, activities, search, super chat events, i18n languages/regions, and video categories/abuse-report-reasons — so AI clients can manage a YouTube channel end to end. It authenticates with Google OAuth using a client secret and a cached token. The server supports stdio (default) and HTTP modes; HTTP mode runs on port 8216 and supports OAuth. Beyond MCP, yutu also offers a standalone CLI and a multi-agent mode (currently Gemini-only) for autonomous YouTube growth workflows.
Tools & capabilities (22)
videoManage YouTube videos: upload, list, update metadata, and delete videos.
playlistManage YouTube playlists: create, list, update, and delete playlists.
playlistItemManage items within YouTube playlists.
playlistImageManage playlist images.
commentManage YouTube comments: post, list, update, and delete comments.
commentThreadManage YouTube comment threads.
captionManage YouTube video captions: list, upload, update, and delete captions.
channelManage YouTube channels and channel metadata.
channelBannerManage YouTube channel banners.
channelSectionManage YouTube channel sections.
thumbnailSet custom thumbnails for YouTube videos.
watermarkSet and manage YouTube channel watermarks.
subscriptionManage YouTube subscriptions: list, subscribe, and unsubscribe.
memberManage YouTube channel members.
membershipsLevelManage YouTube memberships levels.
activityManage and list activities on YouTube.
searchSearch YouTube for videos, channels, and playlists.
superChatEventManage YouTube Super Chat events.
i18nLanguageManage YouTube i18n languages.
i18nRegionManage YouTube i18n regions.
videoCategoryManage YouTube video categories.
videoAbuseReportReasonManage YouTube video abuse report reasons.
What this server can do
yutu provides tools for these capabilities — tap one to see every MCP server that does the same:
When to use it
- Let an AI assistant upload videos and optimize titles, descriptions, and tags for higher click-through and views
- Automate playlist creation and organization across a channel
- Bulk-manage comments and reply to audience engagement
- Manage captions, thumbnails, and channel branding (banners, watermarks, sections)
- Search and retrieve YouTube data (videos, channels, playlists, subscriptions, members) for analysis or reporting
Security notes
Requires Google Cloud OAuth credentials with YouTube Data API v3 access. You must create a GCP project, enable the YouTube Data API v3, create an OAuth Client ID (Desktop app), save it as client_secret.json, then run `yutu auth` to generate youtube.token.json. The MCP server reads these credential and token files via YUTU_CREDENTIAL and YUTU_CACHE_TOKEN. The server can perform destructive operations (delete videos, playlists, comments, captions, subscriptions, channel sections, watermarks) on the authenticated YouTube account, so grant access carefully. Optional HTTP mode supports OAuth client-id/secret authentication. Releases ship cryptographically signed attestations verifiable with `gh attestation verify`.
yutu FAQ
How does authentication work?
yutu uses Google OAuth. Create an OAuth Client ID (Desktop app) in Google Cloud, save it as client_secret.json, and run `yutu auth --credential client_secret.json`. A browser window opens to grant YouTube access, and a token is saved to youtube.token.json. The MCP server reads both files via the YUTU_CREDENTIAL and YUTU_CACHE_TOKEN environment variables.
Which transports does the MCP server support?
Stdio mode by default (`yutu mcp`), and HTTP mode (`yutu mcp --mode http --auth`) which runs on port 8216 and supports OAuth client-id/secret authentication.
How do I add yutu to Claude Code?
Run `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` for stdio mode.
Can it perform destructive actions?
Yes. yutu can delete videos, playlists, comments, captions, subscriptions, channel sections, and watermarks on the authenticated account, so grant access carefully.
Alternatives to yutu
Compare all alternatives →Connect your personal WhatsApp: search, read and send messages and media locally
Powerful Slack MCP with stdio/SSE/HTTP, DMs, group DMs and no-admin token auth
Full Telegram user-account MCP via MTProto: read chats, manage groups, send messages