Skip to main content

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

PyPI version License: MIT Python 3.10+

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

yt_mcp_server-0.1.1.tar.gz (9.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

yt_mcp_server-0.1.1-py3-none-any.whl (9.7 kB view details)

Uploaded Python 3

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

Hashes for yt_mcp_server-0.1.1.tar.gz
Algorithm Hash digest
SHA256 d23bc741d9f01f888c8c186dd11c2c51bd7f535e4247f17af83d16b078746d95
MD5 598b29bde23140337e0e700b183e5c30
BLAKE2b-256 467ab079fccc3d24a7bf19201ea938a4a9ac0b6003e9511070a79a94ef421311

See more details on using hashes here.

Provenance

The following attestation bundles were made for yt_mcp_server-0.1.1.tar.gz:

Publisher: publish.yml on PodevynLoris/youtube-mcp-server

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

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

Hashes for yt_mcp_server-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 21d29901b0a5049f118766a7af2f9a3aa3d390ef650c0f79a9f87a838460f97f
MD5 8f927a8fe5d59ed9342490ac0b3f53da
BLAKE2b-256 c30c4aab699e9fc0ddfb9631e9dbce3844bb070cd2ef102040a881708599d512

See more details on using hashes here.

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

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page