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 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


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.0.tar.gz (9.3 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.0-py3-none-any.whl (9.6 kB view details)

Uploaded Python 3

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

Hashes for yt_mcp_server-0.1.0.tar.gz
Algorithm Hash digest
SHA256 7fb88bde6bdfed25177968037b9b4bd55bdaeee50a9b09e2b16dfe81a61dcca5
MD5 0cf8d4e9322ea03788ec8019c5b4c61d
BLAKE2b-256 84bdb3d41f20193bd087d0b704611089ed807ed3c18175f8d91a3fa305d1395d

See more details on using hashes here.

Provenance

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

Hashes for yt_mcp_server-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 51c0c8c7eb84483c8cd125f01f5a7945fa72a7925841d318930f1ddd841d0e6e
MD5 d84d410d463e4038a7219228e7939943
BLAKE2b-256 a55d486cf8f10a21ec5877dbe00725f855968e834361fd747baa345df0b1039d

See more details on using hashes here.

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

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