YouTube Automation via Rube MCP
Automate YouTube operations through Composio's YouTube toolkit via Rube MCP.
Prerequisites
- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
- Active YouTube connection via
RUBE_MANAGE_CONNECTIONS with toolkit youtube
- Always call
RUBE_SEARCH_TOOLS first to get current tool schemas
Setup
Get Rube MCP: Add https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.
- Verify Rube MCP is available by confirming
RUBE_SEARCH_TOOLS responds
- Call
RUBE_MANAGE_CONNECTIONS with toolkit youtube
- If connection is not ACTIVE, follow the returned auth link to complete Google OAuth
- Confirm connection status shows ACTIVE before running any workflows
Core Workflows
1. Upload and Manage Videos
When to use: User wants to upload a video or update video metadata
Tool sequence:
YOUTUBE_UPLOAD_VIDEO - Upload a new video [Required]
YOUTUBE_UPDATE_VIDEO - Update title, description, tags, privacy [Optional]
YOUTUBE_UPDATE_THUMBNAIL - Set a custom thumbnail [Optional]
Key parameters:
title: Video title (max 100 characters)
description: Video description (max 5000 bytes)
tags: Array of keyword tags
categoryId: YouTube category ID (e.g., '22' for People & Blogs)
privacyStatus: 'public', 'private', or 'unlisted'
videoFilePath: Object with {name, mimetype, s3key} for the video file
Pitfalls:
- UPLOAD_VIDEO consumes high quota; prefer UPDATE_VIDEO for metadata-only changes
- videoFilePath must be an object with s3key, not a raw file path or URL
- Tags total must not exceed 500 characters including separators
- Angle brackets
< > in tags are automatically stripped
- Description limit is 5000 bytes, not characters (multibyte chars count more)
2. Search YouTube Content
When to use: User wants to find videos, channels, or playlists
Tool sequence:
YOUTUBE_SEARCH_YOU_TUBE - Search for content [Required]
YOUTUBE_VIDEO_DETAILS - Get full details for a specific video [Optional]
YOUTUBE_GET_VIDEO_DETAILS_BATCH - Get details for multiple videos [Optional]
Key parameters:
q: Search query (supports exact phrases, exclusions, channel handles)
type: 'video', 'channel', or 'playlist'
maxResults: Results per page (1-50)
pageToken: For pagination
Pitfalls:
- Search endpoint only returns 'snippet' part; use VIDEO_DETAILS for statistics
- Search results are capped at 500 total items
- Search has higher quota cost (100 units) vs list endpoints (1 unit)
- BATCH video details practical limit is ~50 IDs per call; chunk larger sets
3. Manage Playlists
When to use: User wants to create playlists or manage playlist contents
Tool sequence:
YOUTUBE_LIST_USER_PLAYLISTS - List user's existing playlists [Optional]
YOUTUBE_CREATE_PLAYLIST - Create a new playlist [Optional]
YOUTUBE_ADD_VIDEO_TO_PLAYLIST - Add a video to a playlist [Optional]
YOUTUBE_LIST_PLAYLIST_ITEMS - List videos in a playlist [Optional]
Key parameters:
playlistId: Playlist ID ('PL...' for user-created, 'UU...' for uploads)
part: Resource parts to include (e.g., 'snippet,contentDetails')
maxResults: Items per page (1-50)
pageToken: Pagination token from previous response
Pitfalls:
- Do NOT pass channel IDs ('UC...') as playlist IDs; convert 'UC' to 'UU' for uploads
- Large playlists require pagination via pageToken; follow nextPageToken until absent
- items[].id is not the videoId; use items[].snippet.resourceId.videoId
- Creating duplicate playlist names is allowed; check existing playlists first
4. Get Channel and Video Analytics
When to use: User wants to analyze channel performance or video metrics
Tool sequence:
YOUTUBE_GET_CHANNEL_ID_BY_HANDLE - Resolve a handle to channel ID [Prerequisite]
YOUTUBE_GET_CHANNEL_STATISTICS - Get channel subscriber/view/video counts [Required]
YOUTUBE_LIST_CHANNEL_VIDEOS - List all videos from a channel [Optional]
YOUTUBE_GET_VIDEO_DETAILS_BATCH - Get per-video statistics [Optional]
YOUTUBE_GET_CHANNEL_ACTIVITIES - Get recent channel activities [Optional]
Key parameters:
channelId: Channel ID ('UC...'), handle ('@handle'), or 'me'
forHandle: Channel handle (e.g., '@Google')
id: Comma-separated video IDs for batch details
parts: Resource parts to include (e.g., 'snippet,statistics')
Pitfalls:
- Channel statistics are lifetime totals, not per-period
- BATCH video details may return fewer items than requested for private/deleted videos
- Response data may be nested under
data or data_preview; parse defensively
- contentDetails.duration uses ISO 8601 format (e.g., 'PT4M13S')
5. Manage Subscriptions and Comments
When to use: User wants to subscribe to channels or view video comments
Tool sequence:
YOUTUBE_SUBSCRIBE_CHANNEL - Subscribe to a channel [Optional]
YOUTUBE_UNSUBSCRIBE_CHANNEL - Unsubscribe from a channel [Optional]
YOUTUBE_LIST_USER_SUBSCRIPTIONS - List subscriptions [Optional]
YOUTUBE_LIST_COMMENT_THREADS - List comments on a video [Optional]
Key parameters:
channelId: Channel to subscribe/unsubscribe
videoId: Video ID for comment threads
maxResults: Results per page
pageToken: Pagination token
Pitfalls:
- Subscribing to an already-subscribed channel may return an error
- Comment threads return top-level comments with up to 5 replies each
- Comments may be disabled on some videos
- Unsubscribe requires the subscription ID, not the channel ID
Common Patterns
Channel ID Resolution
Handle to Channel ID:
1. Call YOUTUBE_GET_CHANNEL_ID_BY_HANDLE with '@handle'
2. Extract channelId from response
3. Use in subsequent channel operations
Uploads Playlist:
1. Get channel ID (starts with 'UC')
2. Replace 'UC' prefix with 'UU' to get uploads playlist ID
3. Use with LIST_PLAYLIST_ITEMS to enumerate all videos
Pagination
- Set
maxResults (max 50 per page)
- Check response for
nextPageToken
- Pass token as
pageToken in next request
- Continue until
nextPageToken is absent
Batch Video Details
- Collect video IDs from search or playlist listings
- Chunk into groups of ~50 IDs
- Call GET_VIDEO_DETAILS_BATCH per chunk
- Merge results across chunks
Known Pitfalls
Quota Management:
- YouTube API has a daily quota limit (default 10,000 units)
- Upload = 1600 units; search = 100 units; list = 1 unit
- Prefer list endpoints over search when possible
- Monitor quota usage to avoid hitting daily limits
ID Formats:
- Video IDs: 11-character alphanumeric strings
- Channel IDs: Start with 'UC' followed by 22 characters
- Playlist IDs: Start with 'PL' (user) or 'UU' (uploads)
- Do not confuse channel IDs with playlist IDs
Thumbnails:
- Custom thumbnails require channel phone verification
- Must be JPG, PNG, or GIF; under 2MB
- Recommended: 1280x720 resolution (16:9 aspect ratio)
Response Parsing:
- Statistics values are returned as strings, not integers; cast before math
- Duration uses ISO 8601 format (PT#H#M#S)
- Batch responses may wrap data under different keys
Quick Reference
| Task |
Tool Slug |
Key Params |
| Upload video |
YOUTUBE_UPLOAD_VIDEO |
title, description, tags, categoryId, privacyStatus, videoFilePath |
| Update video |
YOUTUBE_UPDATE_VIDEO |
video_id, title, description, tags |
| Set thumbnail |
YOUTUBE_UPDATE_THUMBNAIL |
videoId, thumbnailUrl |
| Search YouTube |
YOUTUBE_SEARCH_YOU_TUBE |
q, type, maxResults |
| Video details |
YOUTUBE_VIDEO_DETAILS |
id, part |
| Batch video details |
YOUTUBE_GET_VIDEO_DETAILS_BATCH |
id, parts |
| List playlists |
YOUTUBE_LIST_USER_PLAYLISTS |
maxResults, pageToken |
| Create playlist |
YOUTUBE_CREATE_PLAYLIST |
(check schema) |
| Add to playlist |
YOUTUBE_ADD_VIDEO_TO_PLAYLIST |
(check schema) |
| List playlist items |
YOUTUBE_LIST_PLAYLIST_ITEMS |
playlistId, maxResults |
| Channel statistics |
YOUTUBE_GET_CHANNEL_STATISTICS |
id/forHandle/mine |
| List channel videos |
YOUTUBE_LIST_CHANNEL_VIDEOS |
channelId, maxResults |
| Channel ID by handle |
YOUTUBE_GET_CHANNEL_ID_BY_HANDLE |
channel_handle |
| Subscribe |
YOUTUBE_SUBSCRIBE_CHANNEL |
channelId |
| List subscriptions |
YOUTUBE_LIST_USER_SUBSCRIPTIONS |
(check schema) |
| List comments |
YOUTUBE_LIST_COMMENT_THREADS |
videoId |
| Channel activities |
YOUTUBE_GET_CHANNEL_ACTIVITIES |
(check schema) |
When to Use
This skill is applicable to execute the workflow or actions described in the overview.
Limitations
- Use this skill only when the task clearly matches the scope described above.
- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.
Source: sickn33/agentic-awesome-skills → skills/youtube-automation/SKILL.md
Also appears in: sickn33/agentic-awesome-skills/plugins/agentic-awesome-skills/skills/youtube-automation/SKILL.md, sickn33/agentic-awesome-skills/plugins/agentic-awesome-skills-claude/skills/youtube-automation/SKILL.md
1---2name: youtube-automation3description: "Automate YouTube tasks via Rube MCP (Composio): upload videos, manage playlists, search content, get analytics, and handle comments. Always search tools first for current schemas."4category: marketing-and-growth5source_repo: sickn33/agentic-awesome-skills6source_path: "skills/youtube-automation/SKILL.md"7source_url: https://github.com/sickn33/agentic-awesome-skills/blob/HEAD/skills/youtube-automation/SKILL.md8metadata:9 source: https://skillmd.com/skills/sickn33/youtube-automation10---111213# YouTube Automation via Rube MCP1415Automate YouTube operations through Composio's YouTube toolkit via Rube MCP.1617## Prerequisites1819- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)20- Active YouTube connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `youtube`21- Always call `RUBE_SEARCH_TOOLS` first to get current tool schemas2223## Setup2425**Get Rube MCP**: Add `https://rube.app/mcp` as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.2627281. Verify Rube MCP is available by confirming `RUBE_SEARCH_TOOLS` responds292. Call `RUBE_MANAGE_CONNECTIONS` with toolkit `youtube`303. If connection is not ACTIVE, follow the returned auth link to complete Google OAuth314. Confirm connection status shows ACTIVE before running any workflows3233## Core Workflows3435### 1. Upload and Manage Videos3637**When to use**: User wants to upload a video or update video metadata3839**Tool sequence**:401. `YOUTUBE_UPLOAD_VIDEO` - Upload a new video [Required]412. `YOUTUBE_UPDATE_VIDEO` - Update title, description, tags, privacy [Optional]423. `YOUTUBE_UPDATE_THUMBNAIL` - Set a custom thumbnail [Optional]4344**Key parameters**:45- `title`: Video title (max 100 characters)46- `description`: Video description (max 5000 bytes)47- `tags`: Array of keyword tags48- `categoryId`: YouTube category ID (e.g., '22' for People & Blogs)49- `privacyStatus`: 'public', 'private', or 'unlisted'50- `videoFilePath`: Object with `{name, mimetype, s3key}` for the video file5152**Pitfalls**:53- UPLOAD_VIDEO consumes high quota; prefer UPDATE_VIDEO for metadata-only changes54- videoFilePath must be an object with s3key, not a raw file path or URL55- Tags total must not exceed 500 characters including separators56- Angle brackets `< >` in tags are automatically stripped57- Description limit is 5000 bytes, not characters (multibyte chars count more)5859### 2. Search YouTube Content6061**When to use**: User wants to find videos, channels, or playlists6263**Tool sequence**:641. `YOUTUBE_SEARCH_YOU_TUBE` - Search for content [Required]652. `YOUTUBE_VIDEO_DETAILS` - Get full details for a specific video [Optional]663. `YOUTUBE_GET_VIDEO_DETAILS_BATCH` - Get details for multiple videos [Optional]6768**Key parameters**:69- `q`: Search query (supports exact phrases, exclusions, channel handles)70- `type`: 'video', 'channel', or 'playlist'71- `maxResults`: Results per page (1-50)72- `pageToken`: For pagination7374**Pitfalls**:75- Search endpoint only returns 'snippet' part; use VIDEO_DETAILS for statistics76- Search results are capped at 500 total items77- Search has higher quota cost (100 units) vs list endpoints (1 unit)78- BATCH video details practical limit is ~50 IDs per call; chunk larger sets7980### 3. Manage Playlists8182**When to use**: User wants to create playlists or manage playlist contents8384**Tool sequence**:851. `YOUTUBE_LIST_USER_PLAYLISTS` - List user's existing playlists [Optional]862. `YOUTUBE_CREATE_PLAYLIST` - Create a new playlist [Optional]873. `YOUTUBE_ADD_VIDEO_TO_PLAYLIST` - Add a video to a playlist [Optional]884. `YOUTUBE_LIST_PLAYLIST_ITEMS` - List videos in a playlist [Optional]8990**Key parameters**:91- `playlistId`: Playlist ID ('PL...' for user-created, 'UU...' for uploads)92- `part`: Resource parts to include (e.g., 'snippet,contentDetails')93- `maxResults`: Items per page (1-50)94- `pageToken`: Pagination token from previous response9596**Pitfalls**:97- Do NOT pass channel IDs ('UC...') as playlist IDs; convert 'UC' to 'UU' for uploads98- Large playlists require pagination via pageToken; follow nextPageToken until absent99- items[].id is not the videoId; use items[].snippet.resourceId.videoId100- Creating duplicate playlist names is allowed; check existing playlists first101102### 4. Get Channel and Video Analytics103104**When to use**: User wants to analyze channel performance or video metrics105106**Tool sequence**:1071. `YOUTUBE_GET_CHANNEL_ID_BY_HANDLE` - Resolve a handle to channel ID [Prerequisite]1082. `YOUTUBE_GET_CHANNEL_STATISTICS` - Get channel subscriber/view/video counts [Required]1093. `YOUTUBE_LIST_CHANNEL_VIDEOS` - List all videos from a channel [Optional]1104. `YOUTUBE_GET_VIDEO_DETAILS_BATCH` - Get per-video statistics [Optional]1115. `YOUTUBE_GET_CHANNEL_ACTIVITIES` - Get recent channel activities [Optional]112113**Key parameters**:114- `channelId`: Channel ID ('UC...'), handle ('@handle'), or 'me'115- `forHandle`: Channel handle (e.g., '@Google')116- `id`: Comma-separated video IDs for batch details117- `parts`: Resource parts to include (e.g., 'snippet,statistics')118119**Pitfalls**:120- Channel statistics are lifetime totals, not per-period121- BATCH video details may return fewer items than requested for private/deleted videos122- Response data may be nested under `data` or `data_preview`; parse defensively123- contentDetails.duration uses ISO 8601 format (e.g., 'PT4M13S')124125### 5. Manage Subscriptions and Comments126127**When to use**: User wants to subscribe to channels or view video comments128129**Tool sequence**:1301. `YOUTUBE_SUBSCRIBE_CHANNEL` - Subscribe to a channel [Optional]1312. `YOUTUBE_UNSUBSCRIBE_CHANNEL` - Unsubscribe from a channel [Optional]1323. `YOUTUBE_LIST_USER_SUBSCRIPTIONS` - List subscriptions [Optional]1334. `YOUTUBE_LIST_COMMENT_THREADS` - List comments on a video [Optional]134135**Key parameters**:136- `channelId`: Channel to subscribe/unsubscribe137- `videoId`: Video ID for comment threads138- `maxResults`: Results per page139- `pageToken`: Pagination token140141**Pitfalls**:142- Subscribing to an already-subscribed channel may return an error143- Comment threads return top-level comments with up to 5 replies each144- Comments may be disabled on some videos145- Unsubscribe requires the subscription ID, not the channel ID146147## Common Patterns148149### Channel ID Resolution150151**Handle to Channel ID**:152```1531. Call YOUTUBE_GET_CHANNEL_ID_BY_HANDLE with '@handle'1542. Extract channelId from response1553. Use in subsequent channel operations156```157158**Uploads Playlist**:159```1601. Get channel ID (starts with 'UC')1612. Replace 'UC' prefix with 'UU' to get uploads playlist ID1623. Use with LIST_PLAYLIST_ITEMS to enumerate all videos163```164165### Pagination166167- Set `maxResults` (max 50 per page)168- Check response for `nextPageToken`169- Pass token as `pageToken` in next request170- Continue until `nextPageToken` is absent171172### Batch Video Details173174- Collect video IDs from search or playlist listings175- Chunk into groups of ~50 IDs176- Call GET_VIDEO_DETAILS_BATCH per chunk177- Merge results across chunks178179## Known Pitfalls180181**Quota Management**:182- YouTube API has a daily quota limit (default 10,000 units)183- Upload = 1600 units; search = 100 units; list = 1 unit184- Prefer list endpoints over search when possible185- Monitor quota usage to avoid hitting daily limits186187**ID Formats**:188- Video IDs: 11-character alphanumeric strings189- Channel IDs: Start with 'UC' followed by 22 characters190- Playlist IDs: Start with 'PL' (user) or 'UU' (uploads)191- Do not confuse channel IDs with playlist IDs192193**Thumbnails**:194- Custom thumbnails require channel phone verification195- Must be JPG, PNG, or GIF; under 2MB196- Recommended: 1280x720 resolution (16:9 aspect ratio)197198**Response Parsing**:199- Statistics values are returned as strings, not integers; cast before math200- Duration uses ISO 8601 format (PT#H#M#S)201- Batch responses may wrap data under different keys202203## Quick Reference204205| Task | Tool Slug | Key Params |206|------|-----------|------------|207| Upload video | YOUTUBE_UPLOAD_VIDEO | title, description, tags, categoryId, privacyStatus, videoFilePath |208| Update video | YOUTUBE_UPDATE_VIDEO | video_id, title, description, tags |209| Set thumbnail | YOUTUBE_UPDATE_THUMBNAIL | videoId, thumbnailUrl |210| Search YouTube | YOUTUBE_SEARCH_YOU_TUBE | q, type, maxResults |211| Video details | YOUTUBE_VIDEO_DETAILS | id, part |212| Batch video details | YOUTUBE_GET_VIDEO_DETAILS_BATCH | id, parts |213| List playlists | YOUTUBE_LIST_USER_PLAYLISTS | maxResults, pageToken |214| Create playlist | YOUTUBE_CREATE_PLAYLIST | (check schema) |215| Add to playlist | YOUTUBE_ADD_VIDEO_TO_PLAYLIST | (check schema) |216| List playlist items | YOUTUBE_LIST_PLAYLIST_ITEMS | playlistId, maxResults |217| Channel statistics | YOUTUBE_GET_CHANNEL_STATISTICS | id/forHandle/mine |218| List channel videos | YOUTUBE_LIST_CHANNEL_VIDEOS | channelId, maxResults |219| Channel ID by handle | YOUTUBE_GET_CHANNEL_ID_BY_HANDLE | channel_handle |220| Subscribe | YOUTUBE_SUBSCRIBE_CHANNEL | channelId |221| List subscriptions | YOUTUBE_LIST_USER_SUBSCRIPTIONS | (check schema) |222| List comments | YOUTUBE_LIST_COMMENT_THREADS | videoId |223| Channel activities | YOUTUBE_GET_CHANNEL_ACTIVITIES | (check schema) |224225## When to Use226This skill is applicable to execute the workflow or actions described in the overview.227228## Limitations229- Use this skill only when the task clearly matches the scope described above.230- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.231- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.232233---234235**Source:** [`sickn33/agentic-awesome-skills`](https://github.com/sickn33/agentic-awesome-skills) → `skills/youtube-automation/SKILL.md`236237**Also appears in:** `sickn33/agentic-awesome-skills/plugins/agentic-awesome-skills/skills/youtube-automation/SKILL.md`, `sickn33/agentic-awesome-skills/plugins/agentic-awesome-skills-claude/skills/youtube-automation/SKILL.md`