Skip to content
MCP server

YouTube MCP

Read YouTube video metadata, transcripts, comments and search results without an API key

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, macOS
Runs
Locally
Version
1.1.1
Listing updated
today

Similar MCP servers

About YouTube MCP

YouTube MCP is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.

This independent, unofficial project gives an assistant six tools for YouTube: search_youtube with filters for upload date and popularity, get_video_info for title, channel, description, duration, views, likes, upload date and tags, get_video_comments, get_video_transcript with timestamps for manual and auto-generated captions, get_transcript_languages, and get_server_info.

By default no YouTube key or account is needed. Metadata, comments and search use an unofficial internal interface through youtubei.js, and transcripts always use youtube-transcript-plus. The README warns that unofficial access may change, break or be blocked, and that YouTube often blocks datacenter IPs with a sign-in-to-confirm-you're-not-a-bot message. For that case you can set YT_PROVIDER=api and supply your own YouTube Data API v3 key, which switches metadata, comments and search, but not transcripts, to the official API. Users are told to decide whether an access method suits them and to follow service terms.

It runs over stdio with npx, or as a Streamable HTTP service on a VPS behind a reverse proxy, with an nginx and systemd walkthrough. It needs Node.js 22 or newer, and the README gives client setup for Claude, Codex, OpenCode, Cursor and VS Code Copilot. The project is not affiliated with YouTube or Google.

Install

Run in a terminal

claude mcp add youtube-mcp --env YOUTUBE_API_KEY='<YOUTUBE_API_KEY>' -- npx -y @granitebps/youtube-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "youtube-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@granitebps/youtube-mcp"
      ],
      "env": {
        "YOUTUBE_API_KEY": "<YOUTUBE_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "youtube-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@granitebps/youtube-mcp"
      ],
      "env": {
        "YOUTUBE_API_KEY": "<YOUTUBE_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "youtube-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@granitebps/youtube-mcp"
      ],
      "env": {
        "YOUTUBE_API_KEY": "<YOUTUBE_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "youtube-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@granitebps/youtube-mcp"
      ],
      "env": {
        "YOUTUBE_API_KEY": "<YOUTUBE_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "youtube-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@granitebps/youtube-mcp"
      ],
      "env": {
        "YOUTUBE_API_KEY": "<YOUTUBE_API_KEY>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • YT_PROVIDERVideo info/comments/search: "innertube" (default, unofficial, no key) or "api" (official YouTube Data API v3). Transcripts always use unofficial youtube-transcript-plus.
  • YOUTUBE_API_KEYYour own YouTube Data API v3 key (BYOK). Required when YT_PROVIDER is "api"; not used for transcripts.

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

search_youtube
Search videos with upload date and popularity filters
get_video_info
Video metadata
get_video_comments
Comment threads with author info and likes
get_video_transcript
Transcript with timestamps
get_transcript_languages
List available caption languages
get_server_info
Server version, provider and backend per tool

What it does

Video search
Searches with upload date and popularity filters.
Video metadata
Title, channel, duration, views, likes, tags and more.
Transcripts
Captions with timestamps, manual or auto-generated.
Comments
Comment threads with authors, likes and included replies.
Optional official API
Switch to YouTube Data API v3 with your own key.
Stdio or HTTP
Run locally or as a Streamable HTTP service.

Good for

  • Summarise a video from its transcript
  • Pull comments on a video for sentiment review
  • Search for recent popular videos on a topic
  • List the caption languages available for a video

Pricing

Open source

Open source; optional YouTube Data API quota applies

More servers for the same service

YouTube MCP FAQ

Do I need a YouTube API key?

Not by default; the unofficial provider needs none, and you can add your own key to use the official API for metadata, comments and search.

Why might it fail from a server?

YouTube often blocks datacenter IPs; the README suggests switching to the official API provider.

Do transcripts use the official API?

No. Transcripts always use youtube-transcript-plus.

Is it affiliated with YouTube?

No. It is independent and unofficial.

Is YouTube MCP free?

Yes. YouTube MCP is open source, so you can use and self-host it for free.

How do I add YouTube MCP to Claude Code?

Run this command in your terminal: claude mcp add youtube-mcp --env YOUTUBE_API_KEY='<YOUTUBE_API_KEY>' -- npx -y @granitebps/youtube-mcp

What are the best alternatives to YouTube MCP?

The closest alternatives to YouTube MCP are Scrapling MCP Server, HyperFrames by HeyGen, TrendRadar, next-ai-draw-io and mcp-for-blender.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers