A zero-config MCP server for YouTube — search videos, get transcripts, browse channels, and search within video content. No API keys needed.
Project description
YouTube MCP Server
A zero-config MCP server for YouTube. Search videos, get transcripts, browse channels, and search across a creator's entire content. No API keys needed.
Quick Start
uvx youtube-mcp-server
Or install with pip:
pip install youtube-mcp-server
Setup
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"youtube": {
"command": "uvx",
"args": ["youtube-mcp-server"]
}
}
}
Claude Code
claude mcp add youtube -- uvx youtube-mcp-server
Cursor
Add to your Cursor MCP settings:
{
"mcpServers": {
"youtube": {
"command": "uvx",
"args": ["youtube-mcp-server"]
}
}
}
Tools
| Tool | Description |
|---|---|
search_channel_transcripts |
Search across ALL videos of a channel — find what any creator said about any topic |
search_transcript |
Search within a single video's transcript |
get_transcript |
Get full transcript with timestamps |
search_videos |
Search YouTube for videos |
get_video_info |
Get video details — title, description, stats, chapters |
get_channel_info |
Get channel info — subscribers, description, video count |
get_channel_videos |
List videos from a channel, sorted by date or popularity |
get_comments |
Get video comments sorted by relevance |
Example Prompts
"Search YouTube for videos about cold outreach strategies"
→ search_videos
"What are the latest videos from @hormozi?"
→ get_channel_videos
"Get me the full transcript of this video: https://youtube.com/watch?v=..."
→ get_transcript
"What does Hormozi say about pricing?"
→ search_channel_transcripts — searches all his videos, returns passages with timestamps
"Compare what YC and Hormozi say about product-market fit"
→ search_channel_transcripts on both channels
HTTP Transport
Run as a standalone HTTP server:
youtube-mcp-server --transport streamable-http --port 8000
Requirements
- Python 3.10+
- yt-dlp (installed automatically)
- No API keys or authentication required
Acknowledgments
Built with the assistance of Claude by Anthropic.
License
MIT
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file yt_mcp_server-0.1.0.tar.gz.
File metadata
- Download URL: yt_mcp_server-0.1.0.tar.gz
- Upload date:
- Size: 9.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7fb88bde6bdfed25177968037b9b4bd55bdaeee50a9b09e2b16dfe81a61dcca5
|
|
| MD5 |
0cf8d4e9322ea03788ec8019c5b4c61d
|
|
| BLAKE2b-256 |
84bdb3d41f20193bd087d0b704611089ed807ed3c18175f8d91a3fa305d1395d
|
Provenance
The following attestation bundles were made for yt_mcp_server-0.1.0.tar.gz:
Publisher:
publish.yml on PodevynLoris/youtube-mcp-server
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
yt_mcp_server-0.1.0.tar.gz -
Subject digest:
7fb88bde6bdfed25177968037b9b4bd55bdaeee50a9b09e2b16dfe81a61dcca5 - Sigstore transparency entry: 1115172301
- Sigstore integration time:
-
Permalink:
PodevynLoris/youtube-mcp-server@b4a5f6e3c5649275bc9a624fb3b7572c8a7a7074 -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/PodevynLoris
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@b4a5f6e3c5649275bc9a624fb3b7572c8a7a7074 -
Trigger Event:
push
-
Statement type:
File details
Details for the file yt_mcp_server-0.1.0-py3-none-any.whl.
File metadata
- Download URL: yt_mcp_server-0.1.0-py3-none-any.whl
- Upload date:
- Size: 9.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
51c0c8c7eb84483c8cd125f01f5a7945fa72a7925841d318930f1ddd841d0e6e
|
|
| MD5 |
d84d410d463e4038a7219228e7939943
|
|
| BLAKE2b-256 |
a55d486cf8f10a21ec5877dbe00725f855968e834361fd747baa345df0b1039d
|
Provenance
The following attestation bundles were made for yt_mcp_server-0.1.0-py3-none-any.whl:
Publisher:
publish.yml on PodevynLoris/youtube-mcp-server
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
yt_mcp_server-0.1.0-py3-none-any.whl -
Subject digest:
51c0c8c7eb84483c8cd125f01f5a7945fa72a7925841d318930f1ddd841d0e6e - Sigstore transparency entry: 1115172334
- Sigstore integration time:
-
Permalink:
PodevynLoris/youtube-mcp-server@b4a5f6e3c5649275bc9a624fb3b7572c8a7a7074 -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/PodevynLoris
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@b4a5f6e3c5649275bc9a624fb3b7572c8a7a7074 -
Trigger Event:
push
-
Statement type: