Connect your AI Agents to YouTube in minutes

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

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.

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 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.

View all tools by creating a free accountSee 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
Copied!

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

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.

Explore other MCP servers built and managed by Merge

gamma
Gamma
github
GitHub
gitlab
GitLab
gmail
Gmail
gong
Gong
google_bigquery
Google BigQuery
google_calendar
Google Calendar
google_docs
Google Docs
google_drive
Google Drive
google_maps
Google Maps
google_meet
Google Meet
google_sheets
Google Sheets
google_slides
Google Slides
grafana
Grafana
greenhouse
Greenhouse
guru
Guru
hex
Hex
hibob
HiBob
hubspot
HubSpot
intercom
Intercom
jira
Jira
jira_service_management
Jira Service Management
kintone
Kintone
klaviyo
Klaviyo

Ready to try it out?

Whether you're an engineer experimenting with agents or a product manager looking to add tools, you can get started for free now