YouTube

YouTube MCP Server for Cloudflare Workers

Available Tools

54 tools available in the YouTube MCP server. Each tool can be called by AI assistants to perform specific actions.

youtube_unsubscribe

Unsubscribe from a YouTube channel.

Requires OAuth authentication.

Args:

subscriptionId: The subscription ID (not the channel ID)

Returns: Confirmation of unsubscription.

{
  "type": "object",
  "required": [
    "subscriptionId"
  ],
  "properties": {
    "subscriptionId": {
      "type": "string",
      "description": "Subscription ID"
    }
  }
}

youtube_list_activities

List channel activity events (uploads, likes, comments, etc.).

Args:

channelId: Channel ID to get activities for (or use mine=true)
mine: Get activities for authenticated user (requires OAuth)
maxResults: Maximum results to return (1-50)
pageToken: Pagination token
publishedAfter: Filter activities after date (RFC 3339)
publishedBefore: Filter activities before date (RFC 3339)
regionCode: Filter by region code
format: Response format

Returns: Paginated list of activity events.

{
  "type": "object",
  "properties": {
    "mine": {
      "type": "boolean",
      "description": "Get my activities"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "channelId": {
      "type": "string",
      "description": "Channel ID"
    },
    "pageToken": {
      "type": "string",
      "description": "Pagination token"
    },
    "maxResults": {
      "type": "integer",
      "default": 25,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum results"
    },
    "regionCode": {
      "type": "string",
      "description": "Region code"
    },
    "publishedAfter": {
      "type": "string",
      "description": "Filter after date (RFC 3339)"
    },
    "publishedBefore": {
      "type": "string",
      "description": "Filter before date (RFC 3339)"
    }
  }
}

youtube_list_captions

List caption tracks for a video.

Requires OAuth authentication for videos you own, or API key for public videos.

Args:

videoId: The video ID
parts: Resource parts to include
format: Response format

Returns: List of caption tracks.

{
  "type": "object",
  "required": [
    "videoId"
  ],
  "properties": {
    "parts": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "default": [
        "snippet"
      ],
      "description": "Resource parts"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "videoId": {
      "type": "string",
      "description": "Video ID"
    }
  }
}

youtube_download_caption

Download a caption track.

Requires OAuth authentication.

Args:

captionId: The caption track ID
format: Caption format (sbv, scc, srt, ttml, vtt)
language: Translate to language code (optional)

Returns: Caption track content.

{
  "type": "object",
  "required": [
    "captionId"
  ],
  "properties": {
    "format": {
      "enum": [
        "sbv",
        "scc",
        "srt",
        "ttml",
        "vtt"
      ],
      "type": "string",
      "description": "Caption format"
    },
    "language": {
      "type": "string",
      "description": "Translate to language code"
    },
    "captionId": {
      "type": "string",
      "description": "Caption track ID"
    }
  }
}

youtube_insert_caption

Upload a caption track for a video.

Requires OAuth authentication. You can only add captions to your own videos.

Args:

videoId: The video ID
language: Caption language code (e.g., 'en', 'es', 'fr')
name: Caption track name
captionData: The caption content (SRT, VTT, etc.)
isDraft: Whether this is a draft (optional)

Returns: Created caption track.

{
  "type": "object",
  "required": [
    "videoId",
    "language",
    "name",
    "captionData"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Track name"
    },
    "isDraft": {
      "type": "boolean",
      "default": false,
      "description": "Is draft"
    },
    "videoId": {
      "type": "string",
      "description": "Video ID"
    },
    "language": {
      "type": "string",
      "description": "Language code"
    },
    "captionData": {
      "type": "string",
      "description": "Caption content"
    }
  }
}

youtube_update_caption

Update a caption track.

Requires OAuth authentication.

Args:

captionId: The caption track ID
isDraft: Whether this is a draft (optional)
captionData: New caption content (optional)

Returns: Updated caption track.

{
  "type": "object",
  "required": [
    "captionId"
  ],
  "properties": {
    "isDraft": {
      "type": "boolean",
      "description": "Is draft"
    },
    "captionId": {
      "type": "string",
      "description": "Caption track ID"
    },
    "captionData": {
      "type": "string",
      "description": "New caption content"
    }
  }
}

youtube_delete_caption

Delete a caption track.

Requires OAuth authentication. You can only delete captions on your own videos.

Args:

captionId: The caption track ID

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "captionId"
  ],
  "properties": {
    "captionId": {
      "type": "string",
      "description": "Caption track ID"
    }
  }
}

youtube_list_video_categories

List video categories available for a region.

Args:

regionCode: ISO 3166-1 alpha-2 country code (default: US)
hl: Language code for localization (optional)
format: Response format

Returns: List of video categories with IDs and titles.

{
  "type": "object",
  "properties": {
    "hl": {
      "type": "string",
      "description": "Language code for localization"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "regionCode": {
      "type": "string",
      "default": "US",
      "description": "Region code"
    }
  }
}

youtube_list_video_abuse_report_reasons

List reasons available for reporting abusive videos.

Args:

hl: Language code for localization (optional)
format: Response format

Returns: List of abuse report reasons with IDs and labels.

{
  "type": "object",
  "properties": {
    "hl": {
      "type": "string",
      "description": "Language code for localization"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

youtube_list_channel_sections

List channel sections (shelves) for a channel.

Args:

channelId: The channel ID
parts: Resource parts to include
format: Response format

Returns: List of channel sections.

{
  "type": "object",
  "required": [
    "channelId"
  ],
  "properties": {
    "parts": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "default": [
        "snippet",
        "contentDetails"
      ],
      "description": "Resource parts"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "channelId": {
      "type": "string",
      "description": "Channel ID"
    }
  }
}

youtube_insert_channel_section

Add a channel section (shelf) to your channel.

Requires OAuth authentication. Maximum 10 sections per channel.

Section types: allPlaylists, completedEvents, liveEvents, multipleChannels, multiplePlaylists, popularUploads, recentUploads, singlePlaylist, subscriptions, upcomingEvents

Args:

type: Section type
title: Section title (optional for some types)
position: Section position (0-indexed)
playlistIds: Playlist IDs (for multiplePlaylists or singlePlaylist)
channelIds: Channel IDs (for multipleChannels)

Returns: Created channel section.

{
  "type": "object",
  "required": [
    "type"
  ],
  "properties": {
    "type": {
      "enum": [
        "allPlaylists",
        "completedEvents",
        "liveEvents",
        "multipleChannels",
        "multiplePlaylists",
        "popularUploads",
        "recentUploads",
        "singlePlaylist",
        "subscriptions",
        "upcomingEvents",
        ""
      ],
      "type": "string",
      "description": "Section type"
    },
    "title": {
      "type": "string",
      "description": "Section title"
    },
    "position": {
      "type": "integer",
      "minimum": 0,
      "description": "Position (0-indexed)"
    },
    "channelIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Channel IDs"
    },
    "playlistIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Playlist IDs"
    }
  }
}

youtube_update_channel_section

Update a channel section.

Requires OAuth authentication.

Args:

sectionId: The section ID to update
type: Section type
title: Section title
position: Section position (0-indexed)
playlistIds: Playlist IDs
channelIds: Channel IDs

Returns: Updated channel section.

{
  "type": "object",
  "required": [
    "sectionId",
    "type"
  ],
  "properties": {
    "type": {
      "type": "string",
      "description": "Section type"
    },
    "title": {
      "type": "string",
      "description": "Section title"
    },
    "position": {
      "type": "integer",
      "minimum": 0,
      "description": "Position"
    },
    "sectionId": {
      "type": "string",
      "description": "Section ID"
    },
    "channelIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Channel IDs"
    },
    "playlistIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Playlist IDs"
    }
  }
}

youtube_delete_channel_section

Delete a channel section.

Requires OAuth authentication.

Args:

sectionId: The section ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "sectionId"
  ],
  "properties": {
    "sectionId": {
      "type": "string",
      "description": "Section ID"
    }
  }
}

youtube_get_my_channel

Get the authenticated user's YouTube channel.

Requires OAuth authentication.

Args:

parts: Resource parts to include (snippet, contentDetails, statistics, status, brandingSettings, topicDetails, auditDetails)
format: Response format

Returns: Channel details for the authenticated user.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

youtube_get_channel

Get a YouTube channel by ID.

Args:

channelId: The YouTube channel ID
parts: Resource parts to include
format: Response format

Returns: Channel details.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "channelId": {
      "type": "string",
      "default": [],
      "description": "YouTube channel ID"
    }
  }
}

youtube_list_channels

Get multiple YouTube channels by ID.

Args:

channelIds: Array of channel IDs (max 50)
parts: Resource parts to include
format: Response format

Returns: List of channel details.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "channelIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "default": [],
      "description": "Array of channel IDs"
    }
  }
}

youtube_get_channel_by_username

Get a YouTube channel by username.

Args:

username: The YouTube username
parts: Resource parts to include
format: Response format

Returns: Channel details.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "username": {
      "type": "string",
      "default": [],
      "description": "YouTube username"
    }
  }
}

youtube_update_channel

Update a YouTube channel's branding settings.

Requires OAuth authentication. You can only update your own channel.

Args:

channelId: The channel ID to update
description: New channel description
keywords: Channel keywords (space-separated)
defaultLanguage: Default language code
country: Country code
unsubscribedTrailer: Video ID for unsubscribed viewer trailer

Returns: Updated channel details.

{
  "type": "object",
  "required": [
    "channelId"
  ],
  "properties": {
    "country": {
      "type": "string",
      "description": "Country code"
    },
    "keywords": {
      "type": "string",
      "description": "Keywords (space-separated)"
    },
    "channelId": {
      "type": "string",
      "description": "Channel ID to update"
    },
    "description": {
      "type": "string",
      "description": "New description"
    },
    "defaultLanguage": {
      "type": "string",
      "description": "Default language code"
    },
    "unsubscribedTrailer": {
      "type": "string",
      "description": "Unsubscribed trailer video ID"
    }
  }
}

youtube_search_channels

Search for YouTube channels.

Args:

query: Search query string
maxResults: Maximum results to return (1-50)
pageToken: Pagination token
order: Sort order (date, rating, relevance, title, videoCount, viewCount)
regionCode: ISO country code
format: Response format

Returns: Search results with channel snippets.

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "order": {
      "enum": [
        "date",
        "rating",
        "relevance",
        "title",
        "videoCount",
        "viewCount"
      ],
      "type": "string"
    },
    "query": {
      "type": "string",
      "description": "Search query"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pageToken": {
      "type": "string",
      "description": "Pagination token"
    },
    "maxResults": {
      "type": "integer",
      "default": 25,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum results"
    },
    "regionCode": {
      "type": "string",
      "description": "ISO country code"
    }
  }
}

youtube_list_comment_threads

List comment threads (top-level comments with replies) for a video or channel.

Args:

videoId: Video ID to get comments for
channelId: Channel ID to get comments for (alternative to videoId)
allThreadsRelatedToChannelId: Get all threads related to a channel
maxResults: Maximum results to return (1-100)
pageToken: Pagination token
order: Sort order (time, relevance)
searchTerms: Filter by search terms
moderationStatus: Filter by moderation status (requires auth)
format: Response format

Returns: Paginated list of comment threads.

{
  "type": "object",
  "properties": {
    "order": {
      "enum": [
        "time",
        "relevance"
      ],
      "type": "string",
      "description": "Sort order"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "videoId": {
      "type": "string",
      "description": "Video ID"
    },
    "channelId": {
      "type": "string",
      "description": "Channel ID"
    },
    "pageToken": {
      "type": "string",
      "description": "Pagination token"
    },
    "maxResults": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum results"
    },
    "searchTerms": {
      "type": "string",
      "description": "Filter by search terms"
    },
    "moderationStatus": {
      "enum": [
        "heldForReview",
        "likelySpam",
        "published"
      ],
      "type": "string",
      "description": "Moderation status"
    },
    "allThreadsRelatedToChannelId": {
      "type": "string",
      "description": "Get all threads related to channel"
    }
  }
}

youtube_get_comment_thread

Get a specific comment thread by ID.

Args:

commentThreadId: The comment thread ID
parts: Resource parts to include
format: Response format

Returns: Comment thread with top-level comment and replies.

{
  "type": "object",
  "required": [
    "commentThreadId"
  ],
  "properties": {
    "parts": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "default": [
        "snippet",
        "replies"
      ],
      "description": "Resource parts"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "commentThreadId": {
      "type": "string",
      "description": "Comment thread ID"
    }
  }
}

youtube_post_comment

Post a new top-level comment on a video or channel.

Requires OAuth authentication.

Args:

channelId: The channel ID (required)
videoId: The video ID (optional - if not provided, posts channel comment)
text: Comment text

Returns: Created comment thread.

{
  "type": "object",
  "required": [
    "channelId",
    "text"
  ],
  "properties": {
    "text": {
      "type": "string",
      "description": "Comment text"
    },
    "videoId": {
      "type": "string",
      "description": "Video ID"
    },
    "channelId": {
      "type": "string",
      "description": "Channel ID"
    }
  }
}

youtube_list_comment_replies

List replies to a comment.

Args:

parentId: The parent comment ID
maxResults: Maximum results to return (1-100)
pageToken: Pagination token
format: Response format

Returns: Paginated list of reply comments.

{
  "type": "object",
  "required": [
    "parentId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "parentId": {
      "type": "string",
      "description": "Parent comment ID"
    },
    "pageToken": {
      "type": "string",
      "description": "Pagination token"
    },
    "maxResults": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum results"
    }
  }
}

youtube_reply_to_comment

Reply to an existing comment.

Requires OAuth authentication.

Args:

parentId: The parent comment ID to reply to
text: Reply text

Returns: Created reply comment.

{
  "type": "object",
  "required": [
    "parentId",
    "text"
  ],
  "properties": {
    "text": {
      "type": "string",
      "description": "Reply text"
    },
    "parentId": {
      "type": "string",
      "description": "Parent comment ID"
    }
  }
}

youtube_update_comment

Update an existing comment.

Requires OAuth authentication. You can only update your own comments.

Args:

commentId: The comment ID to update
text: New comment text

Returns: Updated comment.

{
  "type": "object",
  "required": [
    "commentId",
    "text"
  ],
  "properties": {
    "text": {
      "type": "string",
      "description": "New comment text"
    },
    "commentId": {
      "type": "string",
      "description": "Comment ID to update"
    }
  }
}

youtube_delete_comment

Delete a comment.

Requires OAuth authentication. You can only delete your own comments or comments on your videos.

Args:

commentId: The comment ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "commentId"
  ],
  "properties": {
    "commentId": {
      "type": "string",
      "description": "Comment ID to delete"
    }
  }
}

youtube_set_comment_moderation_status

Set the moderation status of comments.

Requires OAuth authentication. You can only moderate comments on your own videos.

Args:

commentIds: Array of comment IDs to moderate
moderationStatus: New moderation status (heldForReview, published, rejected)
banAuthor: Whether to ban the author from commenting (optional)

Returns: Confirmation of moderation.

{
  "type": "object",
  "required": [
    "commentIds",
    "moderationStatus"
  ],
  "properties": {
    "banAuthor": {
      "type": "boolean",
      "default": false,
      "description": "Ban the author"
    },
    "commentIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Comment IDs to moderate"
    },
    "moderationStatus": {
      "enum": [
        "heldForReview",
        "published",
        "rejected"
      ],
      "type": "string",
      "description": "Moderation status"
    }
  }
}

youtube_list_languages

List application languages supported by YouTube.

Args:

hl: Language code for response localization (optional)
format: Response format

Returns: List of supported languages with codes and names.

{
  "type": "object",
  "properties": {
    "hl": {
      "type": "string",
      "description": "Language code for localization"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

youtube_list_regions

List content regions supported by YouTube.

Args:

hl: Language code for response localization (optional)
format: Response format

Returns: List of supported regions with codes and names.

{
  "type": "object",
  "properties": {
    "hl": {
      "type": "string",
      "description": "Language code for localization"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

youtube_list_members

List channel members (sponsors).

Requires OAuth authentication. Only available for channels with memberships enabled.

Args:

mode: List mode (all_current, updates)
maxResults: Maximum results to return (1-1000)
pageToken: Pagination token
hasAccessToLevel: Filter by membership level ID
filterByMemberChannelId: Filter by specific member channel ID
format: Response format

Returns: Paginated list of channel members.

{
  "type": "object",
  "properties": {
    "mode": {
      "enum": [
        "all_current",
        "updates"
      ],
      "type": "string",
      "default": "all_current",
      "description": "List mode"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pageToken": {
      "type": "string",
      "description": "Pagination token"
    },
    "maxResults": {
      "type": "integer",
      "default": 25,
      "maximum": 1000,
      "minimum": 1,
      "description": "Maximum results"
    },
    "hasAccessToLevel": {
      "type": "string",
      "description": "Filter by membership level ID"
    },
    "filterByMemberChannelId": {
      "type": "string",
      "description": "Filter by member channel ID"
    }
  }
}

youtube_list_membership_levels

List membership levels for the authenticated channel.

Requires OAuth authentication. Only available for channels with memberships enabled.

Args:

parts: Resource parts to include
format: Response format

Returns: List of membership levels.

{
  "type": "object",
  "properties": {
    "parts": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "default": [
        "snippet"
      ],
      "description": "Resource parts"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

youtube_list_playlist_items

List videos in a playlist.

Args:

playlistId: The playlist ID
maxResults: Maximum results to return (1-50)
pageToken: Pagination token
parts: Resource parts to include
format: Response format

Returns: Paginated list of playlist items (videos).

{
  "type": "object",
  "required": [
    "playlistId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pageToken": {
      "type": "string",
      "default": [],
      "description": "Pagination token"
    },
    "maxResults": {
      "type": "integer",
      "default": 25,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum results"
    },
    "playlistId": {
      "type": "string",
      "description": "Playlist ID"
    }
  }
}

youtube_add_video_to_playlist

Add a video to a playlist.

Requires OAuth authentication. You can only add videos to your own playlists.

Args:

playlistId: The playlist ID
videoId: The video ID to add
position: Position in playlist (0-indexed, optional)

Returns: Created playlist item.

{
  "type": "object",
  "required": [
    "playlistId",
    "videoId"
  ],
  "properties": {
    "videoId": {
      "type": "string",
      "description": "Video ID to add"
    },
    "position": {
      "type": "integer",
      "minimum": 0,
      "description": "Position in playlist (0-indexed)"
    },
    "playlistId": {
      "type": "string",
      "description": "Playlist ID"
    }
  }
}

youtube_update_playlist_item

Update a playlist item's position.

Requires OAuth authentication.

Args:

playlistItemId: The playlist item ID
playlistId: The playlist ID
videoId: The video ID
position: New position in playlist (0-indexed)

Returns: Updated playlist item.

{
  "type": "object",
  "required": [
    "playlistItemId",
    "playlistId",
    "videoId",
    "position"
  ],
  "properties": {
    "videoId": {
      "type": "string",
      "description": "Video ID"
    },
    "position": {
      "type": "integer",
      "minimum": 0,
      "description": "New position (0-indexed)"
    },
    "playlistId": {
      "type": "string",
      "description": "Playlist ID"
    },
    "playlistItemId": {
      "type": "string",
      "description": "Playlist item ID"
    }
  }
}

youtube_remove_from_playlist

Remove a video from a playlist.

Requires OAuth authentication. You can only remove videos from your own playlists.

Args:

playlistItemId: The playlist item ID (not the video ID)

Returns: Confirmation of removal.

{
  "type": "object",
  "required": [
    "playlistItemId"
  ],
  "properties": {
    "playlistItemId": {
      "type": "string",
      "description": "Playlist item ID to remove"
    }
  }
}

youtube_list_my_playlists

List the authenticated user's playlists.

Requires OAuth authentication.

Args:

maxResults: Maximum results to return (1-50)
pageToken: Pagination token
parts: Resource parts to include
format: Response format

Returns: Paginated list of playlists.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pageToken": {
      "type": "string",
      "default": [],
      "description": "Pagination token"
    },
    "maxResults": {
      "type": "integer",
      "default": 25,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum results"
    }
  }
}

youtube_list_channel_playlists

List playlists for a specific channel.

Args:

channelId: The channel ID
maxResults: Maximum results to return (1-50)
pageToken: Pagination token
parts: Resource parts to include
format: Response format

Returns: Paginated list of playlists.

{
  "type": "object",
  "required": [
    "channelId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "channelId": {
      "type": "string",
      "description": "Channel ID"
    },
    "pageToken": {
      "type": "string",
      "default": [],
      "description": "Pagination token"
    },
    "maxResults": {
      "type": "integer",
      "default": 25,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum results"
    }
  }
}

youtube_get_playlist

Get a playlist by ID.

Args:

playlistId: The playlist ID
parts: Resource parts to include
format: Response format

Returns: Playlist details.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "playlistId": {
      "type": "string",
      "default": [],
      "description": "Playlist ID"
    }
  }
}

youtube_create_playlist

Create a new playlist.

Requires OAuth authentication.

Args:

title: Playlist title
description: Playlist description
privacyStatus: Privacy status (private, public, unlisted)
defaultLanguage: Default language code

Returns: Created playlist details.

{
  "type": "object",
  "required": [
    "title"
  ],
  "properties": {
    "title": {
      "type": "string",
      "description": "Playlist title"
    },
    "description": {
      "type": "string",
      "description": "Playlist description"
    },
    "privacyStatus": {
      "enum": [
        "private",
        "public",
        "unlisted"
      ],
      "type": "string",
      "default": "private",
      "description": "Privacy status"
    },
    "defaultLanguage": {
      "type": "string",
      "description": "Default language code"
    }
  }
}

youtube_update_playlist

Update a playlist.

Requires OAuth authentication. You can only update your own playlists.

Args:

playlistId: Playlist ID to update
title: New title
description: New description
privacyStatus: New privacy status
defaultLanguage: New default language

Returns: Updated playlist details.

{
  "type": "object",
  "required": [
    "playlistId"
  ],
  "properties": {
    "title": {
      "type": "string",
      "description": "New title"
    },
    "playlistId": {
      "type": "string",
      "description": "Playlist ID to update"
    },
    "description": {
      "type": "string",
      "description": "New description"
    },
    "privacyStatus": {
      "enum": [
        "private",
        "public",
        "unlisted"
      ],
      "type": "string",
      "description": "Privacy status"
    },
    "defaultLanguage": {
      "type": "string",
      "description": "Default language"
    }
  }
}

youtube_delete_playlist

Delete a playlist.

Requires OAuth authentication. You can only delete your own playlists.

Args:

playlistId: Playlist ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "playlistId"
  ],
  "properties": {
    "playlistId": {
      "type": "string",
      "description": "Playlist ID to delete"
    }
  }
}

youtube_search_playlists

Search for YouTube playlists.

Args:

query: Search query string
maxResults: Maximum results to return (1-50)
pageToken: Pagination token
channelId: Filter by channel
format: Response format

Returns: Search results with playlist snippets.

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "channelId": {
      "type": "string",
      "description": "Filter by channel ID"
    },
    "pageToken": {
      "type": "string",
      "description": "Pagination token"
    },
    "maxResults": {
      "type": "integer",
      "default": 25,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum results"
    }
  }
}

youtube_search

Search YouTube for videos, channels, or playlists.

Args:

query: Search query string
type: Resource type to search (video, channel, playlist)
maxResults: Maximum results to return (1-50)
pageToken: Pagination token
order: Sort order (date, rating, relevance, title, videoCount, viewCount)
channelId: Filter by channel
publishedAfter: Filter by publish date (RFC 3339)
publishedBefore: Filter by publish date (RFC 3339)
regionCode: ISO country code
relevanceLanguage: Relevance language code
safeSearch: Safe search setting (moderate, none, strict)
eventType: Filter live events (completed, live, upcoming)
location: Geographic coordinates (lat,lng)
locationRadius: Search radius (e.g., "100km", "50mi")
topicId: Freebase topic ID
videoCategoryId: Video category ID
videoDefinition: Filter by definition (any, high, standard)
videoDimension: Filter by dimension (2d, 3d, any)
videoDuration: Filter by duration (any, long, medium, short)
videoEmbeddable: Filter embeddable videos (any, true)
videoLicense: Filter by license (any, creativeCommon, youtube)
videoType: Filter by type (any, episode, movie)
format: Response format

Returns: Search results with resource snippets.

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "type": {
      "enum": [
        "video",
        "channel",
        "playlist"
      ],
      "type": "string",
      "description": "Resource type"
    },
    "order": {
      "enum": [
        "date",
        "rating",
        "relevance",
        "title",
        "videoCount",
        "viewCount"
      ],
      "type": "string"
    },
    "query": {
      "type": "string",
      "description": "Search query"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "topicId": {
      "type": "string",
      "description": "Freebase topic ID"
    },
    "location": {
      "type": "string",
      "description": "Geographic coordinates (lat,lng)"
    },
    "channelId": {
      "type": "string",
      "description": "Filter by channel ID"
    },
    "eventType": {
      "enum": [
        "completed",
        "live",
        "upcoming"
      ],
      "type": "string",
      "description": "Live event type"
    },
    "pageToken": {
      "type": "string",
      "description": "Pagination token"
    },
    "videoType": {
      "enum": [
        "any",
        "episode",
        "movie"
      ],
      "type": "string"
    },
    "maxResults": {
      "type": "integer",
      "default": 25,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum results"
    },
    "regionCode": {
      "type": "string",
      "description": "ISO country code"
    },
    "safeSearch": {
      "enum": [
        "moderate",
        "none",
        "strict"
      ],
      "type": "string",
      "description": "Safe search"
    },
    "videoLicense": {
      "enum": [
        "any",
        "creativeCommon",
        "youtube"
      ],
      "type": "string"
    },
    "videoDuration": {
      "enum": [
        "any",
        "long",
        "medium",
        "short"
      ],
      "type": "string"
    },
    "locationRadius": {
      "type": "string",
      "description": "Search radius"
    },
    "publishedAfter": {
      "type": "string",
      "description": "Published after (RFC 3339)"
    },
    "videoDimension": {
      "enum": [
        "2d",
        "3d",
        "any"
      ],
      "type": "string"
    },
    "publishedBefore": {
      "type": "string",
      "description": "Published before (RFC 3339)"
    },
    "videoCategoryId": {
      "type": "string",
      "description": "Video category ID"
    },
    "videoDefinition": {
      "enum": [
        "any",
        "high",
        "standard"
      ],
      "type": "string"
    },
    "videoEmbeddable": {
      "enum": [
        "any",
        "true"
      ],
      "type": "string"
    },
    "relevanceLanguage": {
      "type": "string",
      "description": "Relevance language code"
    }
  }
}

youtube_list_my_subscriptions

List the authenticated user's subscriptions.

Requires OAuth authentication.

Args:

maxResults: Maximum results to return (1-50)
pageToken: Pagination token
parts: Resource parts to include
format: Response format

Returns: Paginated list of subscriptions.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pageToken": {
      "type": "string",
      "default": [],
      "description": "Pagination token"
    },
    "maxResults": {
      "type": "integer",
      "default": 25,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum results"
    }
  }
}

youtube_list_my_subscribers

List the authenticated user's subscribers.

Requires OAuth authentication.

Args:

maxResults: Maximum results to return (1-50)
pageToken: Pagination token
parts: Resource parts to include
format: Response format

Returns: Paginated list of subscribers.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pageToken": {
      "type": "string",
      "default": [],
      "description": "Pagination token"
    },
    "maxResults": {
      "type": "integer",
      "default": 25,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum results"
    }
  }
}

youtube_subscribe

Subscribe to a YouTube channel.

Requires OAuth authentication.

Args:

channelId: The channel ID to subscribe to

Returns: Created subscription.

{
  "type": "object",
  "required": [
    "channelId"
  ],
  "properties": {
    "channelId": {
      "type": "string",
      "description": "Channel ID to subscribe to"
    }
  }
}

youtube_get_video

Get details for a YouTube video by ID.

Args:

videoId: The YouTube video ID
parts: Resource parts to include (snippet, contentDetails, statistics, status, player, topicDetails, recordingDetails, liveStreamingDetails)
format: Response format ('json' or 'markdown')

Returns: Video details including title, description, statistics, and more.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "videoId": {
      "type": "string",
      "default": [],
      "description": "YouTube video ID"
    }
  }
}

youtube_list_videos

Get details for multiple YouTube videos by ID.

Args:

videoIds: Array of YouTube video IDs (max 50)
parts: Resource parts to include
format: Response format

Returns: List of video details.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "videoIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "default": [],
      "description": "Array of YouTube video IDs"
    }
  }
}

youtube_search_videos

Search for YouTube videos.

Args:

query: Search query string
maxResults: Maximum results to return (1-50)
pageToken: Pagination token
order: Sort order (date, rating, relevance, title, viewCount)
channelId: Filter by channel
publishedAfter: Filter by publish date (RFC 3339)
publishedBefore: Filter by publish date (RFC 3339)
regionCode: ISO country code
videoDuration: Filter by duration (any, long, medium, short)
videoDefinition: Filter by definition (any, high, standard)
videoType: Filter by type (any, episode, movie)
eventType: Filter live events (completed, live, upcoming)
format: Response format

Returns: Search results with video snippets.

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "order": {
      "enum": [
        "date",
        "rating",
        "relevance",
        "title",
        "viewCount"
      ],
      "type": "string",
      "description": "Sort order"
    },
    "query": {
      "type": "string",
      "description": "Search query"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "channelId": {
      "type": "string",
      "description": "Filter by channel ID"
    },
    "eventType": {
      "enum": [
        "completed",
        "live",
        "upcoming"
      ],
      "type": "string",
      "description": "Filter live events"
    },
    "pageToken": {
      "type": "string",
      "description": "Pagination token"
    },
    "videoType": {
      "enum": [
        "any",
        "episode",
        "movie"
      ],
      "type": "string",
      "description": "Filter by type"
    },
    "maxResults": {
      "type": "integer",
      "default": 25,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum results"
    },
    "regionCode": {
      "type": "string",
      "description": "ISO country code"
    },
    "safeSearch": {
      "enum": [
        "moderate",
        "none",
        "strict"
      ],
      "type": "string",
      "description": "Safe search setting"
    },
    "videoDuration": {
      "enum": [
        "any",
        "long",
        "medium",
        "short"
      ],
      "type": "string",
      "description": "Filter by duration"
    },
    "publishedAfter": {
      "type": "string",
      "description": "Filter videos published after (RFC 3339)"
    },
    "publishedBefore": {
      "type": "string",
      "description": "Filter videos published before (RFC 3339)"
    },
    "videoDefinition": {
      "enum": [
        "any",
        "high",
        "standard"
      ],
      "type": "string",
      "description": "Filter by definition"
    }
  }
}

youtube_update_video

Update a YouTube video's metadata.

Requires OAuth authentication. You can only update videos on your own channel.

Args:

videoId: The video ID to update
title: New title
description: New description
tags: New tags array
categoryId: New category ID
privacyStatus: New privacy status (private, public, unlisted)
embeddable: Whether the video can be embedded
madeForKids: Whether the video is made for kids

Returns: Updated video details.

{
  "type": "object",
  "required": [
    "videoId"
  ],
  "properties": {
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "New tags"
    },
    "title": {
      "type": "string",
      "description": "New title"
    },
    "videoId": {
      "type": "string",
      "description": "Video ID to update"
    },
    "categoryId": {
      "type": "string",
      "description": "New category ID"
    },
    "embeddable": {
      "type": "boolean",
      "description": "Whether video can be embedded"
    },
    "description": {
      "type": "string",
      "description": "New description"
    },
    "madeForKids": {
      "type": "boolean",
      "description": "Made for kids designation"
    },
    "privacyStatus": {
      "enum": [
        "private",
        "public",
        "unlisted"
      ],
      "type": "string",
      "description": "Privacy status"
    }
  }
}

youtube_delete_video

Delete a YouTube video.

Requires OAuth authentication. You can only delete videos on your own channel.

Args:

videoId: The video ID to delete

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "videoId"
  ],
  "properties": {
    "videoId": {
      "type": "string",
      "description": "Video ID to delete"
    }
  }
}

youtube_rate_video

Rate a YouTube video (like, dislike, or remove rating).

Requires OAuth authentication.

Args:

videoId: The video ID to rate
rating: Rating to apply (like, dislike, none)

Returns: Confirmation of rating.

{
  "type": "object",
  "required": [
    "videoId",
    "rating"
  ],
  "properties": {
    "rating": {
      "enum": [
        "like",
        "dislike",
        "none"
      ],
      "type": "string",
      "description": "Rating to apply"
    },
    "videoId": {
      "type": "string",
      "description": "Video ID to rate"
    }
  }
}

youtube_get_video_rating

Get your rating for one or more videos.

Requires OAuth authentication.

Args:

videoIds: Array of video IDs to check

Returns: Your rating for each video.

{
  "type": "object",
  "required": [
    "videoIds"
  ],
  "properties": {
    "videoIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Video IDs to check"
    }
  }
}

youtube_report_video_abuse

Report a video for abusive content.

Requires OAuth authentication.

Args:

videoId: The video ID to report
reasonId: Abuse reason ID (from youtube_list_video_abuse_report_reasons)
secondaryReasonId: Secondary reason ID (optional)
comments: Additional comments (optional)

Returns: Confirmation of report.

{
  "type": "object",
  "required": [
    "videoId",
    "reasonId"
  ],
  "properties": {
    "videoId": {
      "type": "string",
      "description": "Video ID to report"
    },
    "comments": {
      "type": "string",
      "description": "Additional comments"
    },
    "reasonId": {
      "type": "string",
      "description": "Abuse reason ID"
    },
    "secondaryReasonId": {
      "type": "string",
      "description": "Secondary reason ID"
    }
  }
}