> This page is for Workforce.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# YouTube

**Authentication:** OAuth. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow, or [Application credentials](/merge-agent-handler/admin-setup/add-oauth-credentials) to bring your own OAuth app.

## Sample use cases

* Pull view counts and watch time for the channel's last 10 videos.
* Find videos uploaded in the last 30 days with engagement below average.
* Search YouTube for videos covering our latest product launch.

## Available Tools

#### list_channels

List YouTube channels by ID, username, or 'mine' flag. Use page_token from page_info for next page.

#### update_channel

Update YouTube channel metadata (description, keywords, language, country). Requires OAuth2.

#### list_comment_threads

List top-level comment threads for a video or channel. Use page_token from page_info for next page.

#### create_comment_thread

Post a new top-level comment on a YouTube video. Requires OAuth2.

#### list_comments

List replies to a comment thread. Use page_token from page_info for next page.

#### create_comment

Reply to an existing YouTube comment thread. Requires OAuth2.

#### update_comment

Edit a YouTube comment's text. Requires OAuth2.

#### delete_comment

Delete a YouTube comment by ID. This action is irreversible. Requires OAuth2.

#### list_playlist_items

List items in a YouTube playlist with pagination. Use page_token from page_info for next page.

#### add_playlist_item

Add a video to a YouTube playlist at an optional position. Requires OAuth2.

#### update_playlist_item

Update a playlist item's position or note. Requires OAuth2.

#### remove_playlist_item

Remove an item from a YouTube playlist by playlist item ID. Requires OAuth2.

#### list_playlists

List YouTube playlists by ID, channel ID, or 'mine' flag. Use page_token from page_info for next page.

#### create_playlist

Create a new YouTube playlist with title, description, and privacy setting. Requires OAuth2.

#### update_playlist

Update YouTube playlist metadata (title, description, privacy). Requires OAuth2.

#### delete_playlist

Delete a YouTube playlist by ID. This action is irreversible. Requires OAuth2.

#### search

Search YouTube for videos, channels, or playlists. Costs 100 quota units per call. Use page_token for next page.

#### list_subscriptions

List YouTube subscriptions by channel ID or 'mine' flag. Use page_token from page_info for next page.

#### create_subscription

Subscribe to a YouTube channel. Requires OAuth2.

#### delete_subscription

Unsubscribe from a YouTube channel by subscription ID. Requires OAuth2.

#### list_videos

List YouTube videos by ID, chart (mostPopular), or user rating. At least one filter (id, chart, or my_rating) is required. Use page_token from page_info for next page.

#### get_video

Get a YouTube video by ID with specified parts (snippet, contentDetails, statistics, status).

#### insert_video

Create video metadata (title, description, tags, privacy). Note: file upload requires resumable upload protocol.

#### update_video

Update video metadata (title, description, tags, privacy, category). Requires OAuth2.

#### delete_video

Delete a YouTube video by ID. This action is irreversible. Requires OAuth2.

#### rate_video

Rate a YouTube video (like, dislike, or none to remove rating). Requires OAuth2.