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.2.tar.gz (9.5 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.2-py3-none-any.whl (9.8 kB view details)

Uploaded Python 3

File details

Details for the file yt_mcp_server-0.1.2.tar.gz.

File metadata

  • Download URL: yt_mcp_server-0.1.2.tar.gz
  • Upload date:
  • Size: 9.5 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.2.tar.gz
Algorithm Hash digest
SHA256 833c33afb3b68c29d12e1f7913db5a66d89bcebb12bdfbe2ea3f644aa45f0411
MD5 71f57444a7caac35777f206874fee17d
BLAKE2b-256 f0cc6db48f59b86c25261d6bed235e0fcf99a2a546d2f4d8113bed210290cce9

See more details on using hashes here.

Provenance

The following attestation bundles were made for yt_mcp_server-0.1.2.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.2-py3-none-any.whl.

File metadata

  • Download URL: yt_mcp_server-0.1.2-py3-none-any.whl
  • Upload date:
  • Size: 9.8 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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 4023eaa7694ca57a188d001007ded1e5f48c73ecb84526c000e8ff6a68d0cc09
MD5 d3c510c67ac29b0e36b5379f39d59abf
BLAKE2b-256 cb7f0d3fc356648bb58cf45ac413172c5994e05977c026179c7eaccc97b2ccbd

See more details on using hashes here.

Provenance

The following attestation bundles were made for yt_mcp_server-0.1.2-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