Which integrations are available for this server?

Scrapes YouTube video search results, video details, channel info, playlists, and comments.

How do I use youtube-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@youtube-mcp search for latest music videos" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

youtube-mcp

by iamkw0n

Overview Schema Source Related Servers Discussions Admin

TypeScript

Local

⚠️ Important Notices

IMPORTANT

This projectdoes not use the official YouTube Data API v3. It parses public web pages (ytInitialData). If YouTube changes its page structure, some features may break. Personal, non-commercial use is recommended.

WARNING

Excessive requests may get blocked by YouTube. If that happens often, enable the Zyte proxy with theZYTE_API_KEY environment variable.

Related MCP server: mcp-apps

✨ Features


🔍 Video search	Keyword search with sort, date, and duration filters
📺 Video details	Views, likes, duration, and more by ID or URL
📡 Channels	Look up channels by ID, @handle, or URL
📋 Playlists	Playlist metadata and video lists
💬 Comments	Top and recent comments on a video
🔌 stdio MCP	Works with Cursor, Claude, Codex, and other local clients
🔑 No API key	No Google Cloud API key required

🚀 Quick Start

git clone https://github.com/iamkw0n/youtube-mcp.git
cd youtube-mcp
npm install
npm run build
npm start

Or run directly with tsx:

npx tsx src/index.ts

🛠 Tools

Tool	Description
`search_videos`	Search videos by keyword
`get_video`	Get video details by ID or URL
`get_videos`	Batch-fetch multiple videos
`search_channels`	Search channels by keyword
`get_channel`	Get channel info by ID, @handle, or URL
`get_channel_videos`	List recent videos from a channel
`get_playlist`	Get playlist metadata
`get_playlist_items`	List videos in a playlist
`get_video_comments`	Fetch video comments
`api_status`	Check scraping and proxy status

💬 One-Click Install Prompt

Paste this into Cursor, Claude Code, or Codex to ask the agent to install the MCP server:

Clone iamkw0n/youtube-mcp from GitHub and set up the MCP server for me.

🔧 Client Setup

Client	Config file	stdio
Cursor	`.cursor/mcp.json`	✅
Claude Code	`.mcp.json`	✅
Claude Desktop	`claude_desktop_config.json`	✅
Codex	`.codex/config.toml`	✅
ChatGPT	Connector URL	❌

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "youtube-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/youtube-mcp/dist/index.js"],
      "cwd": "/absolute/path/to/youtube-mcp"
    }
  }
}

With Zyte proxy (optional):

{
  "mcpServers": {
    "youtube-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/youtube-mcp/dist/index.js"],
      "cwd": "/absolute/path/to/youtube-mcp",
      "env": {
        "ZYTE_API_KEY": "${env:ZYTE_API_KEY}"
      }
    }
  }
}

Claude Code

Add to .mcp.json in your project root:

{
  "mcpServers": {
    "youtube-mcp": {
      "type": "stdio",
      "command": "node",
      "args": ["/absolute/path/to/youtube-mcp/dist/index.js"]
    }
  }
}

CLI:

claude mcp add youtube-mcp -s project -- node /absolute/path/to/youtube-mcp/dist/index.js

Claude Desktop

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "youtube-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/youtube-mcp/dist/index.js"],
      "cwd": "/absolute/path/to/youtube-mcp"
    }
  }
}

WARNING

Claude Desktop does not support${workspaceFolder}. Use absolute paths.

OpenAI Codex

In .codex/config.toml or ~/.codex/config.toml:

[mcp_servers.youtube-mcp]
command = "node"
args = ["/absolute/path/to/youtube-mcp/dist/index.js"]
cwd = "/absolute/path/to/youtube-mcp"
enabled = true

CLI:

codex mcp add youtube-mcp -- node /absolute/path/to/youtube-mcp/dist/index.js

Verify in a Codex session with /mcp.

ChatGPT

IMPORTANT

ChatGPT connectors only supportHTTPS MCP endpoints. This repo is a local stdio server and cannot be connected to ChatGPT directly.

💡 Examples

Search YouTube for TypeScript tutorial videos

Get details for this video: https://www.youtube.com/watch?v=dQw4w9WgXcQ

Show me the 5 most recent videos from @GoogleDevelopers

What videos are in this playlist? https://www.youtube.com/playlist?list=PL...

⚙️ How It Works

flowchart LR
    A[MCP Client] -->|stdio| B[youtube-mcp]
    B -->|fetch HTML| C[www.youtube.com]
    B -->|parse| D[ytInitialData]
    B -->|pagination| E[InnerTube continuation]

Step	Description
Page fetch	Download public YouTube HTML pages
Data extraction	Parse `ytInitialData` and `ytInitialPlayerResponse` JSON
Pagination	Load more results via InnerTube continuation tokens

📄 License

MIT © iamkw0n

Available Tools

10 tools

api_statusA

YouTube 스크래핑 상태, 요청 횟수, Zyte 프록시 사용 여부를 확인합니다.

Inputs: no named parameters.

get_channelA

채널 ID, @핸들, 또는 URL로 YouTube 채널 정보를 조회합니다.

Inputs: channelIdOrHandleOrUrl (required).

get_channel_videosC

채널의 최근 동영상 목록을 조회합니다.

Inputs: channelIdOrHandleOrUrl (required), maxResults, order, pageToken.

get_playlistB

재생목록 ID 또는 URL로 YouTube 재생목록 정보를 조회합니다.

Inputs: playlistIdOrUrl (required).

get_playlist_itemsB

재생목록에 포함된 동영상 목록을 조회합니다.

Inputs: playlistIdOrUrl (required), maxResults, pageToken.

get_videoA

동영상 ID 또는 URL로 YouTube 동영상 상세를 조회합니다.

Inputs: videoIdOrUrl (required).

get_video_commentsB

동영상의 인기 댓글 또는 최신 댓글을 조회합니다.

Inputs: videoIdOrUrl (required), maxResults, order, pageToken.

get_videosA

여러 동영상 ID 또는 URL로 YouTube 동영상을 일괄 조회합니다.

Inputs: videoIdsOrUrls (required).

search_channelsC

키워드로 YouTube 채널을 검색합니다.

Inputs: query (required), maxResults, order, regionCode, +1 more.

search_videosB

키워드로 YouTube 동영상을 검색합니다.

Inputs: query (required), maxResults, order, publishedAfter, +4 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A3.7/5.0

Scored 2026-06-09 15:50 across 10 tools

Disambiguation5/5

Each tool targets a distinct resource or action (status, channel, channel videos, playlist, playlist items, video, video comments, batch videos, search channels, search videos) with no overlaps.

Naming Consistency5/5

All tool names follow a consistent verb_noun pattern (get_*, search_*) except api_status which is a single status check. Naming is predictable and uniform.

Tool Count5/5

10 tools is perfectly scoped for YouTube data retrieval: covering channels, videos, playlists, comments, search, and status. No unnecessary tools.

Completeness5/5

The surface covers all major read operations for YouTube: channel info, channel videos, playlist info, playlist items, video details (single and batch), comments, and search for both channels and videos.

Resources

Related MCP Connectors

YouTube Transcript + YouTube Search MCPA
com.getyoutubetranscript
YouTube transcripts, search, channel browsing, and playlists for AI agents via MCP.
Entertainment & Media Search Web Scraping
13114
https://getyoutubetranscript.com/api/mcp
YoutubeA
io.github.pipeworx-io
YouTube MCP — wraps the YouTube Data API v3 (BYO API key)
Entertainment & Media Search App Automation
502
https://gateway.pipeworx.io/youtube/mcp
YouTube Transcript, Comments & Video Data API MCP Server
io.youtubeapi
Real-time YouTube transcripts, comments, channels & video search MCP. Local npx or hosted OAuth.
Entertainment & Media Social Media Search
1
https://mcp.youtubeapi.io/v1/mcp
YTAPIA
dev.ytapi
YouTube transcripts, comments, video details, heatmaps, search, channels and playlists.
Entertainment & Media Social Media Search
101
https://api.ytapi.dev/mcp

Related MCP Servers

YouTube MCP Server
Entertainment & Media Search
anirudhyadavMS
A
license
A
quality
D
maintenance
Enables YouTube content browsing, video searching, and metadata retrieval via the YouTube Data API v3. It also facilitates fetching video transcripts for summarization and analysis within MCP-compatible AI clients.
Updated 10 months ago (2026-01-24 09:38 UTC)
7
26 npm
1
MIT
mcp-apps
Entertainment & Media Search
0GiS0
A
license
Not graded
quality
D
maintenance
Enables interacting with YouTube Data API v3 through MCP tools (get-video, get-channel, get-latest-video) and bundled UI apps for video and channel profiles.
Updated 7 months ago (2026-04-16 01:59 UTC)
7 npm
4
MIT
YouTube Search MCP Server
Entertainment & Media Web Scraping Audio Processing
sacahan
A
license
A
quality
D
maintenance
Enables YouTube video search and audio download via web scraping, requiring no API key.
Updated a year ago (2025-12-10 03:11 UTC)
1
MIT
YouTube MCP Server
Entertainment & Media Social Media
DivyaV18
F
license
A
quality
D
maintenance
Enables interaction with YouTube's Data API through MCP, providing tools for channel info, videos, playlists, captions, subscriptions, and more.
Updated 9 months ago (2026-01-30 15:07 UTC)
14
-

⚠️ Important Notices

✨ Features

🚀 Quick Start

🛠 Tools

💬 One-Click Install Prompt

🔧 Client Setup

Cursor

Claude Code

Claude Desktop

OpenAI Codex

ChatGPT

💡 Examples

⚙️ How It Works

📄 License

Available Tools

Tool Schema Changelog

TDQS

Resources

Related MCP Connectors

Related MCP Servers

YouTube MCP Server

mcp-apps

YouTube Search MCP Server

YouTube MCP Server