Skip to main content
Glama

YouTube MCP Server

A Model Context Protocol (MCP) server that enables Claude Desktop (and other applications) to interact with YouTube, providing search and transcript functionality.

Features

  • Search YouTube Videos: Search for videos with customizable result counts

  • Get Video Transcripts: Extract transcripts from YouTube videos using URLs or video IDs

  • AI-Ready Integration: Seamlessly integrates with Claude Desktop for YouTube content analysis

Tools Available

1. search_youtube_videos

  • Purpose: Search YouTube for videos based on a query

  • Parameters:

    • search_term (string): The search query

    • num_videos (int): Number of videos to return (default: 5, max: 50)

  • Returns: List of video information including titles, channels, descriptions, URLs, and metadata

2. get_youtube_transcript

  • Purpose: Extract transcript from a YouTube video

  • Parameters:

    • video_url_or_title (string): YouTube video URL or video ID

  • Returns: Full transcript with timestamps and metadata

3. analyze_youtube_content_prompt

  • Purpose: AI prompt template for comprehensive YouTube content analysis

  • Parameters:

    • search_term (string): Topic to analyze

    • num_videos (int): Number of videos to analyze

Setup

1. Install Dependencies

# Create virtual environment python3 -m venv .venv # Activate virtual environment source .venv/bin/activate # Install dependencies pip install -r requirements.txt

2. Get YouTube API Key

  1. Go to Google Cloud Console

  2. Create a new project or select existing one

  3. Enable YouTube Data API v3

  4. Create credentials (API Key)

  5. Copy the API key

3. Configure Environment

# Copy example environment file cp .env.example .env # Edit .env and add your YouTube API key YOUTUBE_API_KEY=your_actual_api_key_here

4. Test the Server

# Activate virtual environment source .venv/bin/activate # Run the server python youtube_server.py

Integration with Claude Desktop

Add this configuration to your Claude Desktop MCP settings:

{ "mcpServers": { "youtube": { "command": "local/path/to/uv", "args": [ "run", "--directory", "/Path/to/your/project", "youtube_server.py" ], "env": { "YOUTUBE_API_KEY": "your_key_here" } } }

Usage Examples

Once integrated with Claude Desktop, you can:

  • "Search for videos about machine learning and get transcripts"

  • "Find the latest videos on climate change and analyze their content"

  • "Get the transcript of this YouTube video: https://www.youtube.com/watch?v=..."

  • "Compare different perspectives on AI ethics from YouTube videos"

Error Handling

  • Missing API Key: Server will warn and search functionality will be limited

  • Invalid Video IDs: Clear error messages for transcript requests

  • API Limits: Respects YouTube API quotas and rate limits

  • Missing Transcripts: Handles videos without available captions

Dependencies

  • fastmcp: MCP server framework

  • google-api-python-client: YouTube Data API access

  • youtube-transcript-api: Transcript extraction

License

This project is open source and available under standard licensing terms.

Install Server
A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/bendelpino/youtube-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server