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 yt-mcp-server
Or install with pip:
pip install yt-mcp-server
Setup
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"youtube": {
"command": "uvx",
"args": ["--from", "yt-mcp-server", "youtube-mcp-server"]
}
}
}
Claude Code
claude mcp add youtube -- uvx yt-mcp-server
Cursor
Add to your Cursor MCP settings:
{
"mcpServers": {
"youtube": {
"command": "uvx",
"args": ["--from", "yt-mcp-server", "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
"Find me the best videos on how to scale a B2B SaaS from 0 to $1M ARR"
→ search_videos
"Show me everything @AlexHormozi posted this month"
→ get_channel_videos
"Summarize this interview with Sam Altman: https://youtube.com/watch?v=..."
→ get_transcript
"What exactly did @AlexHormozi say about scaling a SaaS? Give me the timestamps"
→ search_channel_transcripts — searches all videos, returns exact passages with links
"Compare how @ycombinator and @AlexHormozi think about product-market fit"
→ search_channel_transcripts on both channels
HTTP Transport
Run as a standalone HTTP server:
yt-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.1.tar.gz.
File metadata
- Download URL: yt_mcp_server-0.1.1.tar.gz
- Upload date:
- Size: 9.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d23bc741d9f01f888c8c186dd11c2c51bd7f535e4247f17af83d16b078746d95
|
|
| MD5 |
598b29bde23140337e0e700b183e5c30
|
|
| BLAKE2b-256 |
467ab079fccc3d24a7bf19201ea938a4a9ac0b6003e9511070a79a94ef421311
|
Provenance
The following attestation bundles were made for yt_mcp_server-0.1.1.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.1.tar.gz -
Subject digest:
d23bc741d9f01f888c8c186dd11c2c51bd7f535e4247f17af83d16b078746d95 - Sigstore transparency entry: 1115442047
- Sigstore integration time:
-
Permalink:
PodevynLoris/youtube-mcp-server@afa514b7f33b62d44fee2f402b72e430ef839daf -
Branch / Tag:
refs/tags/v0.1.1 - Owner: https://github.com/PodevynLoris
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@afa514b7f33b62d44fee2f402b72e430ef839daf -
Trigger Event:
push
-
Statement type:
File details
Details for the file yt_mcp_server-0.1.1-py3-none-any.whl.
File metadata
- Download URL: yt_mcp_server-0.1.1-py3-none-any.whl
- Upload date:
- Size: 9.7 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 |
21d29901b0a5049f118766a7af2f9a3aa3d390ef650c0f79a9f87a838460f97f
|
|
| MD5 |
8f927a8fe5d59ed9342490ac0b3f53da
|
|
| BLAKE2b-256 |
c30c4aab699e9fc0ddfb9631e9dbce3844bb070cd2ef102040a881708599d512
|
Provenance
The following attestation bundles were made for yt_mcp_server-0.1.1-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.1-py3-none-any.whl -
Subject digest:
21d29901b0a5049f118766a7af2f9a3aa3d390ef650c0f79a9f87a838460f97f - Sigstore transparency entry: 1115442048
- Sigstore integration time:
-
Permalink:
PodevynLoris/youtube-mcp-server@afa514b7f33b62d44fee2f402b72e430ef839daf -
Branch / Tag:
refs/tags/v0.1.1 - Owner: https://github.com/PodevynLoris
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@afa514b7f33b62d44fee2f402b72e430ef839daf -
Trigger Event:
push
-
Statement type: