# YouTube MCP

> YouTube MCP is an open-source MCP server for design and media. Read YouTube video metadata, transcripts, comments and search results without an API key. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, macOS, Linux, Windows
- **Repository:** https://github.com/granitebps/youtube-mcp
- **MCP Registry name:** io.github.granitebps/youtube-mcp
- **Categories:** [design and media](https://ai-powered.com/categories/design-and-media), [web search and scraping](https://ai-powered.com/categories/web-search-and-scraping), [news and media](https://ai-powered.com/categories/news-and-media)
- **Listing updated:** 2026-11-18

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

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

## Alternatives

- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [TrendRadar](https://ai-powered.com/mcp/trendradar): TrendRadar is an open-source MCP server for communication.
- [next-ai-draw-io](https://ai-powered.com/mcp/next-ai-draw-io-2): next-ai-draw-io is an open-source MCP server for ai models and llm tooling.
- [mcp-for-blender](https://ai-powered.com/mcp/mcp-for-blender): mcp-for-blender is an open-source MCP server for design and media.
- [Firecrawl MCP Server](https://ai-powered.com/mcp/firecrawl-mcp-server): Firecrawl MCP Server is a freemium MCP server for web search and scraping.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Douyin_TikTok_Download_API](https://ai-powered.com/mcp/douyin-tiktok-download-api): Douyin_TikTok_Download_API is an open-source MCP server for web search and scraping.

---
Source: https://ai-powered.com/mcp/youtube-mcp-3
