# youtube-mcp

Search YouTube videos, channels, and playlists, then inspect metadata or timestamped transcripts. Useful when an agent needs evidence from video content.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 3827 installs
- Author: sfiorini
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/sfiorini/youtube-mcp
- Updated: 2025-11-20
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/sfiorini-youtube-mcp

## What it does

youtube-mcp lets an agent search YouTube and inspect individual videos, channels, and playlists. Results can include titles, descriptions, URLs, duration, and channel or playlist details.

It can retrieve transcripts in multiple languages with timestamps and locate terms inside captions. Separate tools cover video lookup, channel video lists, playlist items, and transcript retrieval.

The MCP server is reached through the remote endpoint `https://youtube-mcp--sfiorini.run.tools`. Requests through it depend on that endpoint being reachable.

## Requirements
- Remote server: `https://youtube-mcp--sfiorini.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http youtube-mcp https://youtube-mcp--sfiorini.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add sfiorini-youtube-mcp --url https://youtube-mcp--sfiorini.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "sfiorini-youtube-mcp": {
            "url": "https://youtube-mcp--sfiorini.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "sfiorini-youtube-mcp": {
            "type": "http",
            "url": "https://youtube-mcp--sfiorini.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http sfiorini-youtube-mcp https://youtube-mcp--sfiorini.run.tools
```

## When to use it
- search YouTube for videos on a topic
- retrieve a video transcript with timestamps
- locate a phrase inside captions
- list videos published by a channel
- inspect the items in a playlist

## Example prompts
- Search YouTube for videos about PostgreSQL migration and return their titles, URLs, and durations.
- Fetch the transcript for this video and find every mention of `vacuum`.
- List the videos in this playlist and summarize what each one covers.

## Similar
- [transcriptapi](https://affpapa.org/en/nevibecode/skills/transcriptapi.md) — skill · 895 installs
- [yt](https://affpapa.org/en/nevibecode/skills/yt.md) — skill · 757 installs
- [YouTube Transcript + YouTube Search MCP](https://affpapa.org/en/nevibecode/mcp/youtube-transcript-youtube-search-mcp.md) — MCP server · ★ 10 repo stars
- [youtube-summarize](https://affpapa.org/en/nevibecode/mcp/youtube-summarize.md) — MCP server · ★ 6 repo stars
- [youtube-api](https://affpapa.org/en/nevibecode/skills/youtube-api.md) — skill · 4700 installs
- [HasData YouTube](https://affpapa.org/en/nevibecode/mcp/hasdata-youtube.md) — MCP server · ★ 8 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
