Connect your AI Agents to YouTube in minutes

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.

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}
11Open 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}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 }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}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
























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
