Merge Unified's YouTube integration Merge Agent Handler's YouTube MCP server

Connect your AI Agents to YouTube in minutes

Merge lets you securely connect your agents to YouTube and thousands of tools instantly

Start building for free

Read docs

YouTube

Learn more about Merge Agent Handler

Available tools

list_channels

List YouTube channels by ID, username, or 'mine' flag. Use pagetoken from pageinfo 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 pagetoken from pageinfo 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 pagetoken from pageinfo 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 pagetoken from pageinfo 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 pagetoken from pageinfo 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 pagetoken from pageinfo for next page.

create_subscription

Subscribe to a YouTube channel. Requires OAuth2.

delete_subscription

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

validate_credential

Validate YouTube credentials by making a lightweight API call. Returns {success, message}.

list_videos

List YouTube videos by ID, chart (mostPopular), or user rating. At least one filter (id, chart, or myrating) is required. Use pagetoken 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.

View all tools by creating a free account See more tools

How to set up Merge Agent Handler

In an mcp.json file, add the configuration below, and restart Cursor.

Learn more in the official documentation ↗

1{
2  "mcpServers": {
3    "agent-handler": {
4      "url": "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
5      "headers": {
6        "Authorization": "Bearer yMt*****"
7      }
8    }
9  }
10}
11

Copy Code

Open your Claude Desktop configuration file and add the server configuration below. You'll also need to restart the application for the changes to take effect.

Make sure Claude is using the Node v20+.

Learn more in the official documentation ↗

1{
2  "mcpServers": {
3    "agent-handler": {
4      "command": "npx",
5      "args": [
6        "-y",
7        "mcp-remote@latest",
8        "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
9        "--header",
10        "Authorization: Bearer ${AUTH_TOKEN}"
11      ],
12      "env": {
13        "AUTH_TOKEN": "yMt*****"
14      }
15    }
16  }
17}

Copy Code

Open your Windsurf MCP configuration file and add the server configuration below.
Click on the refresh button in the top right of the Manage MCP server page or in the top right of the chat box in the box icon.

Learn more in the official documentation ↗

1{
2    "mcpServers": {
3      "agent-handler": {
4        "command": "npx",
5        "args": [
6          "-y",
7          "mcp-remote@latest",
8          "https://ah-api.merge.dev/api/v1/tool-packs/<tool-pack-id>/registered-users/<registered-user-id>/mcp",
9          "--header",
10          "Authorization: Bearer ${AUTH_TOKEN}"
11        ],
12        "env": {
13          "AUTH_TOKEN": "<ah-production-access-key>"
14        }
15      }
16    }
17  }

Copy Code

In Command Palette (Cmd+Shift+P on macOS, Ctrl+Shift+P on Windows), run "MCP: Open User Configuration".

You can then add the configuration below and press "start" right under servers. Enter the auth token when prompted.

Learn more in the official documentation ↗

1{
2  "inputs": [
3    {
4      "type": "promptString",
5      "id": "agent-handler-auth",
6      "description": "Agent Handler AUTH_TOKEN", // "yMt*****" when prompt
7      "password": true
8    }
9  ],
10  "servers": {
11    "agent-handler": {
12      "type": "stdio",
13      "command": "npx",
14      "args": [
15        "-y",
16        "mcp-remote@latest",
17        "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
18        "--header",
19        "Authorization: Bearer ${input:agent-handler-auth}"
20      ]
21    }
22  }
23}

Copy Code

FAQs on using Merge's YouTube MCP server

What is a Youtube MCP server?

It’s an MCP server that lets you access data and functionality from a Youtube instance via tools. Your agents can invoke these tools to update a channel, add comments, list playlists, and more.

Youtube doesn’t currently support an “official” MCP server. You can use community MCP servers instead, or leverage one from a 3rd-party platform, like Merge Agent Handler.

How can I use a Youtube MCP server?

Here are a few popular use cases:

Content repurposing at scale: Pull transcripts and metadata so your agents can quickly turn videos into blogs, newsletters, social posts, and FAQs with consistent messaging

SEO and topic strategy: Analyze your videos (and competitors’) to identify recurring keywords, themes, and gaps. Then convert those insights into a prioritized content roadmap

Campaign messaging and creative angles: Mine transcripts and comments to surface pains, objections, and language patterns that can be translated into ad copy, webinar themes, and email nurture narratives

Sales enablement briefs: Auto-generate crisp summaries of demos/webinars (who it’s for, value props, differentiators) so sales can reuse them in decks and follow-ups

Competitor monitoring: Track new uploads from competitor channels and automatically produce “what changed” summaries that inform positioning and pricing conversations

What are some common tools in a Youtube MCP server?

Here are a few:

<code class="blog_inline-code">search_videos</code>: Searches YouTube for videos by keyword and common filters (e.g., relevance, date), returning structured video results your app can display or further process

<code class="blog_inline-code">get_video</code>: Retrieves detailed information for a single video by ID, including title, description, thumbnails, and basic statistics

<code class="blog_inline-code">list_channel_videos</code>: Lists videos uploaded by a specific channel (by channel ID), typically with pagination so you can iterate through all of a channel’s content

<code class="blog_inline-code">get_channel</code>: Fetches information about a single channel by ID, such as its title, description, thumbnails, and key statistics

<code class="blog_inline-code">get_transcript</code>: Obtains the captions/transcript for a video (when available), returning the spoken content as text for search, analysis, or summarization

What makes Merge Agent Handler’s YouTube MCP server better than alternative YouTube MCP servers?

Merge Agent Handler provides several platform-level advantages:

End-to-end authentication and credential management: Merge handles authentication flows, credential storage, and authorization prompts automatically, reducing integration complexity for developers

Enterprise-grade security with DLP enforcement: All tool inputs and outputs are scanned through a security gateway that can block, redact, or mask sensitive data based on configurable rules

Real-time observability with fully-searchable logs: Every tool call and underlying API request is logged, enabling developers to monitor, audit, debug, and optimize agent behavior with a complete audit trail

Evaluation Suite for pre-production validation: Developers can define evaluation scenarios and validate tool outputs against expected results before deploying to production

Connector Studio for customization: Teams can modify existing connectors or create new ones with full control over tool definitions and behavior

Can I set custom security rules for YouTube tool calls in Merge Agent Handler?

Yes, Merge Agent Handler includes a security gateway with data loss protection (DLP) that allows you to define custom rules for tool calls. Here are some examples:

Protect brand reputation: Require approval before any public comment/reply or content edit posts to YouTube

Prevent data leakage and compliance incidents: Redact/block sensitive info (PII, secrets) in YouTube tool-call inputs/outputs

Reduce “oops we scraped everything” risk: Enforce scope and volume limits for allowlisted channels/playlists and caps on bulk pulls

Keep customer/community engagement high-quality: Allow “draft only” responses; block publishing so a human reviews before anything goes live

Maintain auditability for stakeholders: Alert on policy violations (e.g., attempted posting or bulk export) with searchable logs for review

How can I start using Merge Agent Handler’s Youtube MCP server?

Take the following steps:

1. Create (or sign in to) your Merge Agent Handler account and open the Agent Handler dashboard.

2. Create a Tool Pack for your YouTube workflow (Tool Packs define which tools/connectors your agent is allowed to call).

3. Add the YouTube connector to that Tool Pack, and start by enabling only the specific YouTube tools you need (generally start read-only, then add write actions).

4. Create a Registered User (the execution identity boundary), then authenticate the YouTube connector for that Registered User so tool calls run under the right permissions/YouTube account.

5. Copy the MCP endpoint URL for your Tool Pack and Registered User (it follows the standard Agent Handler MCP URL pattern that includes both IDs).

6. Connect your MCP client (e.g., Claude Desktop/Cursor/VS Code/Windsurf) to that MCP endpoint and include the required auth header/token; then refresh tools in the client.

7. Test with a couple of safe read actions first (e.g., search / list videos) and confirm the tool-call logs look correct; then try a small write action only after you’re comfortable with the behavior.

Can employees use Merge Agent Handler to connect their AI tools to YouTube?

Yes, Agent Handler for Employees lets your employees connect Claude, ChatGPT, Microsoft Copilot, Cursor, and other MCP-compatible AI tools to YouTube without bypassing IT governance.

Instead of setting up direct connections with personal credentials that IT can't monitor or revoke, each employee authenticates through Agent Handler and gets individual credentials tied to their identity.

IT also provisions access by role or group via SCIM. A content creator, for example, gets YouTube access to manage video uploads and review analytics, Notion to track content calendars and video briefs, and Slack to coordinate with the production team on publishing schedules; while a marketing manager gets YouTube access to monitor channel performance and audience metrics, Google Sheets to report on video ROI, and HubSpot to correlate video engagement with lead generation data.

Every tool call an employee's AI makes to YouTube is also inspected against your DLP rules and logged to a searchable audit trail, giving security teams full visibility into what data was accessed and by whom.