# youtube-mcp

Search and browse videos, channels, and playlists to fetch titles, descriptions, stats, and durations.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add sfiorini/youtube-mcp

# Browse available tools
npx -y @smithery/cli@latest tool list sfiorini/youtube-mcp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get sfiorini/youtube-mcp videos_getVideo

# Call a tool
npx -y @smithery/cli@latest tool call sfiorini/youtube-mcp videos_getVideo '{}'
```

## Direct MCP Connection

Endpoint: `https://youtube-mcp--sfiorini.run.tools`

**Optional config:**
- `youtubeApiKey` (query) — Your YouTube Data API v3 key. Required for all operations. Can also be provided via YOUTUBE_API_KEY environment variable.
- `youtubeTranscriptLang` (query) — Default language code for YouTube transcripts (e.g., 'en', 'es', 'fr', 'de')

## Tools (7)

- `videos_getVideo` — Get detailed information about a YouTube video including URL
- `videos_searchVideos` — Search for videos on YouTube and return results with URLs
- `transcripts_getTranscript` — Get the transcript of a YouTube video
- `channels_getChannel` — Get information about a YouTube channel
- `channels_listVideos` — Get videos from a specific channel
- `playlists_getPlaylist` — Get information about a YouTube playlist
- `playlists_getPlaylistItems` — Get videos in a YouTube playlist

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get sfiorini/youtube-mcp <tool-name>
```

## Resources

- `youtube://info` — Information about available YouTube MCP resources and how to use them

## Prompts (2)

- `summarize-video` (videoId) — Summarize a YouTube video
- `analyze-channel` (channelId) — Analyze a YouTube channel

---

Source: https://github.com/sfiorini/youtube-mcp