YouTube MCP
Read YouTube video metadata, transcripts, comments and search results without an API key
- 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-mcpAdd 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.



