youtube_account_add
Connect a new YouTube channel by running the OAuth flow and saving it under a named profile. After this you can target it with channel: '<name>' in any tool.
LABSCO SUMMARY
Named profiles are the organising idea.
Youtube_account_add stores each connected channel under a name, a channel argument sends a call to that profile, and youtube_account_remove refuses to remove the last one. The destructive calls are gated the same way throughout — youtube_video_delete, youtube_playlist_delete and youtube_account_remove each require confirm: true — and youtube_comment_delete is honest about its limit, working only on comments the authenticated account owns. Analytics is split into narrow queries rather than a single dashboard call, which is what makes a monthly report assemblable: per-video metrics, channel metrics, top videos by a chosen metric, the audience-retention curve, and revenue split into estimated, ad and gross. One detail that will bite during playlist work: youtube_playlist_item_remove takes the playlistItem ID, not the video ID it points at.
What it is
A YouTube channel-management server covering uploads and scheduling, video metadata, playlists, comment moderation, channel branding and YouTube Analytics, with named profiles so a single server can act on more than one channel.
What you get
- Uploads with the publishing decision attached: youtube_video_upload takes filePath, title, description, tags, categoryId, language, privacyStatus, notifySubscribers and thumbnailPath; youtube_video_schedule_publish sets an ISO8601 publishAt; youtube_video_set_premiere configures a premiere date with a countdown.
- Edits after the fact: youtube_video_update changes title, description, tags and category, youtube_video_set_privacy switches between public, private and unlisted, youtube_video_set_thumbnail replaces the thumbnail, and youtube_video_rate applies or clears a like or dislike.
- Analytics as specific queries rather than one dashboard: youtube_analytics_video_metrics returns views, watch time, retention and CTR for a video over a date range with chosen dimensions; youtube_analytics_channel_metrics covers views, subscribers, watch time and revenue; youtube_analytics_top_videos ranks by a chosen metric; youtube_analytics_audience_retention returns the retention curve; youtube_analytics_revenue_report returns estimated, ad and gross revenue.
- Comment work including moderation: youtube_comment_list pages threads with searchTerms and ordering, youtube_comment_thread_get returns a thread with its replies, youtube_comment_reply posts under a parentCommentId, youtube_comment_moderate publishes, holds or rejects a comment and can ban its author, and youtube_comment_delete removes comments owned by the authenticated account.
- Playlists as ordered objects: youtube_playlist_create, youtube_playlist_update, youtube_playlist_get and youtube_playlist_list handle the playlist itself; youtube_playlist_item_add inserts at a position, youtube_playlist_item_reorder moves an item to a newPosition, and youtube_playlist_item_remove takes the playlistItem ID rather than the video ID.
- Channel presentation: youtube_channel_update sets title, description, keywords, country and default language; youtube_channel_branding_update sets banner, profile image and featured channels; youtube_channel_watermark_set places a watermark with position and timing across the channel's videos and youtube_channel_watermark_unset removes it; the youtube_channel_section calls build, list and delete homepage sections.
- Named channel profiles: youtube_account_add runs the OAuth flow and saves a channel under a name, youtube_account_switch changes the active profile, youtube_account_list and youtube_account_current report the state, and a channel argument sends an individual call to a specific profile.
- Deletions behind an explicit confirmation: youtube_video_delete, youtube_playlist_delete and youtube_account_remove each require confirm set to true.
Requirements
An OAuth client for YouTube — YOUTUBE_CLIENT_ID and YOUTUBE_CLIENT_SECRET — and a channel connected through youtube_account_add, which runs the OAuth flow and stores the channel under a named profile.
Setup effort
One command plus credentials — npx maagpi-youtube-mcp, then supply credentials
USE CASES
01
Publishing a video at a time you are not at your desk
Upload the file with its metadata and privacy set, put the thumbnail on it, and let the scheduler make it public at the moment you chose.
02
Working out where viewers drop off and doing something about it
Read the retention curve for the video, check it against the video's wider metrics, then change the metadata that framed it.
03
Keeping the comments under a video civil
Page through the threads, open the ones that need context, hold or reject what breaks the rules, and answer the rest.
04
Rebuilding a playlist's running order
List what is in it with positions, add what is missing, move things into the order you want, and drop what no longer belongs.
05
Putting the month's channel report together
Pull the channel-level numbers, find which videos carried them, and add what the period actually earned.
06
Switching between the channels you manage
Connect each channel once under a name, see which profiles exist, and move the active one before you start work.
42 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
youtube_account_current
Show the currently active channel profile.
youtube_account_list
List all connected YouTube channel profiles with their names, channel IDs, and active status.
youtube_account_remove
Disconnect and remove a channel profile. Requires confirm: true. Cannot remove the last profile.
youtube_account_switch
Switch the active channel profile. All tools without an explicit channel parameter will use this profile.
youtube_analytics_audience_retention
Get audience retention curve data for a specific video showing where viewers drop off.
youtube_analytics_channel_metrics
Query channel-level analytics: views, subscribers, watch time, revenue, and more.
youtube_analytics_revenue_report
Get revenue report including estimated revenue, ad revenue, and gross revenue.
youtube_analytics_top_videos
Get top performing videos for a date range ranked by a specific metric.
youtube_analytics_video_metrics
Query YouTube Analytics for detailed per-video metrics (views, watch time, retention, CTR, etc.).
youtube_channel_branding_update
Update channel branding settings including banner, background color, and related channels.
youtube_channel_get
Get the authenticated channel's metadata, branding settings, and statistics.
youtube_channel_section_create
Create a new channel homepage section featuring playlists or channels.
youtube_channel_section_delete
Delete a channel homepage section by ID.
youtube_channel_section_list
List all sections on the channel homepage.
youtube_channel_update
Update the channel's title, description, keywords, country, or default language.
youtube_channel_watermark_set
Set a branding watermark image on all channel videos with position and timing configuration.
youtube_channel_watermark_unset
Remove the branding watermark from all channel videos.
youtube_comment_delete
Delete a comment by ID. Only works on comments owned by the authenticated account.
youtube_comment_list
List top-level comment threads on a video, with optional search and ordering.
youtube_comment_moderate
Change moderation status of a comment: publish, hold for review, or reject. Optionally ban the author.
youtube_comment_reply
Post a reply to an existing top-level comment on a video.
youtube_comment_thread_get
Get a single comment thread with its replies.
youtube_playlist_create
Create a new YouTube playlist with title, description, and privacy settings.
youtube_playlist_delete
Permanently delete a playlist. Requires confirm: true.
youtube_playlist_get
Get a playlist's full metadata by ID.
youtube_playlist_item_add
Add a video to a playlist at an optional position.
youtube_playlist_item_remove
Remove a video from a playlist using the playlistItem ID (not the video ID).
youtube_playlist_item_reorder
Move a playlist item to a new position within the playlist.
youtube_playlist_items_list
List all videos in a playlist with their positions and metadata.
youtube_playlist_list
List playlists for a channel (or the authenticated user's channel).
youtube_playlist_update
Update a playlist's title, description, or privacy status.
youtube_video_delete
Permanently delete a video. Requires confirm: true to prevent accidents.
youtube_video_get
Get full metadata for a YouTube video by ID.
youtube_video_list
List videos on a channel or search across YouTube with filters.
youtube_video_rate
Like, dislike, or remove a rating from a video.
youtube_video_schedule_publish
Schedule a video to automatically publish at a specific future datetime (ISO8601).
youtube_video_set_premiere
Configure a video as a YouTube Premiere with a scheduled live premiere date.
youtube_video_set_privacy
Change the privacy status of a video to public, private, or unlisted.
youtube_video_set_thumbnail
Upload and set a custom thumbnail for a video.
youtube_video_update
Update the metadata of an existing video (title, description, tags, category).
youtube_video_upload
Upload a video file to YouTube with metadata and privacy settings.
BEFORE YOU INSTALL
What to know first
Tools you get
42 tools when we connected. Write tools spend YouTube API quota from a 10,000 unit daily budget, and youtube_video_upload alone costs 1600. Tools that delete data require confirm: true.
Requires
- npx on PATH
- YOUTUBE_CLIENT_ID in your environment
- YOUTUBE_CLIENT_SECRET in your environment
CONTEXT COST
Moderate Standing cost
Rated by the size of the 42 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npx maagpi-youtube-mcpMCP Clients
Claude Desktop, Claude Code, Cursor, Windsurf
JSON
{
"mcpServers": {
"youtube": {
"command": "npx",
"args": [
"-y",
"maagpi-youtube-mcp"
],
"env": {
"YOUTUBE_CLIENT_ID": "<YOUR_YOUTUBE_CLIENT_ID>",
"YOUTUBE_CLIENT_SECRET": "<YOUR_YOUTUBE_CLIENT_SECRET>"
}
}
}
}VS Code
VS CODE · JSON
{
"servers": {
"youtube": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"maagpi-youtube-mcp"
],
"env": {
"YOUTUBE_CLIENT_ID": "<YOUR_YOUTUBE_CLIENT_ID>",
"YOUTUBE_CLIENT_SECRET": "<YOUR_YOUTUBE_CLIENT_SECRET>"
}
}
}
}Zed
ZED · JSON
{
"context_servers": {
"youtube": {
"command": {
"path": "npx",
"args": [
"-y",
"maagpi-youtube-mcp"
],
"env": {
"YOUTUBE_CLIENT_ID": "<YOUR_YOUTUBE_CLIENT_ID>",
"YOUTUBE_CLIENT_SECRET": "<YOUR_YOUTUBE_CLIENT_SECRET>"
}
}
}
}
}mcporter
MCPORTER · TERMINAL
mcporter add youtube --command "npx -y maagpi-youtube-mcp" \
--env YOUTUBE_CLIENT_ID=<YOUR_YOUTUBE_CLIENT_ID> \
--env YOUTUBE_CLIENT_SECRET=<YOUR_YOUTUBE_CLIENT_SECRET>
