YouTube Research MCP Server

Citation-ready YouTube transcript research and optional channel intelligence for AI agents.

Local serverstdioTypeScript

What is the YouTube Research MCP Server?

Citation-ready YouTube transcript research and optional channel intelligence for AI agents.

What you get

Turn YouTube videos into citation-ready research for Codex, Claude, Cursor, and other MCP clients. Paste a video URL and get transcript evidence with timestamps and links that open at the exact quoted moment.

  • Citation-ready research — — every transcript segment includes a timestamp and source URL
  • Zero-key quick start — — transcripts work immediately; add an API key only for search and analytics
  • URL-first input — — accepts normal, short, Shorts, embed, live, and raw video-ID formats
  • Agent-efficient filtering — — search inside transcripts and return nearby context instead of spending tokens on the entire video
  • Full YouTube intelligence — — optional API mode adds comments, video/channel statistics, trends, and comparisons
  • Remote-native MCP — — Streamable HTTP transport at /mcp, plus Docker and Smithery support

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
research-videoGet citation-ready transcript evidence from a URL or video ID without an API key
research-videosCompare timestamp-linked evidence across 2–5 videos without an API key
search-videosSearch for YouTube videos with advanced filtering options
get-video-commentsGet comments for a specific video
get-video-transcriptGet transcript for a specific video with optional language
enhanced-transcriptAdvanced transcript extraction with filtering, search, and multi-video capabilities
get-key-momentsExtract key moments with timestamps from a video transcript for easier navigation
get-segmented-transcriptDivide a video transcript into segments for easier analysis
get-video-statsGet statistical information for a specific video
get-channel-statsGet subscriber count, view count, and other channel statistics
compare-videosCompare statistics across multiple videos
get-trending-videosRetrieve trending videos by region and category
get-video-categoriesGet available video categories for a specific region
analyze-channel-videosAnalyze performance trends of videos from a specific channel

How to install the YouTube Research MCP Server

{
  "mcpServers": {
    "youtube-research": {
      "command": "npx",
      "args": ["-y", "@coyasong/youtube-mcp-server"],
      "env": {
        "YOUTUBE_API_KEY": "your-value",
        "MCP_BEARER_TOKEN": "your-value",
        "CORS_ORIGIN": "your-value",
        "MAX_SESSIONS": "your-value",
        "SESSION_IDLE_TIMEOUT_MS": "your-value",
        "YOUTUBE_MCP_TOKEN": "your-value",
        "VIDEO_ID": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
YOUTUBE_API_KEYCredential the server authenticates with.Yes
MCP_BEARER_TOKENCredential the server authenticates with.Yes
CORS_ORIGINConfiguration value read at startup.Optional
MAX_SESSIONSConfiguration value read at startup.Optional
SESSION_IDLE_TIMEOUT_MSConfiguration value read at startup.Optional
YOUTUBE_MCP_TOKENCredential the server authenticates with.Yes
VIDEO_IDConfiguration value read at startup.Optional

Example prompts to try

  • “Use YouTube Research MCP to research-video.”
  • “Use YouTube Research MCP to research-videos.”
  • “Use YouTube Research MCP to search-videos.”

Frequently asked questions

Citation-ready YouTube transcript research and optional channel intelligence for AI agents. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.