youtube-mcp — Claude Code MCP server: video and transcript search
Search YouTube videos, channels, and playlists, then inspect metadata or timestamped transcripts. Useful when an agent needs evidence from video content.
no license 3,827 installs updated 2025-11-20
claude mcp add --transport http youtube-mcp https://youtube-mcp--sfiorini.run.toolsWhat youtube-mcp 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.
What it helps with
- 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 for the agent
- 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.
How to install youtube-mcp
Platform CLI: remote server
claude mcp add --transport http youtube-mcp https://youtube-mcp--sfiorini.run.toolsPlatform CLI: remote server
codex mcp add sfiorini-youtube-mcp --url https://youtube-mcp--sfiorini.run.toolsConfig file
{
"mcpServers": {
"sfiorini-youtube-mcp": {
"url": "https://youtube-mcp--sfiorini.run.tools"
}
}
}Config file
{
"servers": {
"sfiorini-youtube-mcp": {
"type": "http",
"url": "https://youtube-mcp--sfiorini.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http sfiorini-youtube-mcp https://youtube-mcp--sfiorini.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about youtube-mcp
How do I install youtube-mcp in Claude Code?
Run claude mcp add --transport http youtube-mcp https://youtube-mcp--sfiorini.run.tools.
What does youtube-mcp do?
It searches YouTube videos, channels, and playlists, returns their details, and fetches timestamped transcripts. Captions can be searched for specific context.
What can youtube-mcp return for a video?
It can provide the video URL, title, description, statistics, and duration. Transcript results include text and timestamps when available for the video.