YouTube

A Model Context Protocol (MCP) server that provides YouTube Data API v3 integration for content discovery and management. This server enables AI assistants to search for YouTube videos, channels, and perform various content-related operations.

jupyter-notebook

GitHub Stars

jupyter-notebook

Language

4 months ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "nastyrunner13-youtube-content-management-mcp": {
      "command": "python",
      "args": [
        "/path/to/youtube-content-management-mcp/main.py"
      ],
      "env": {
        "DEBUG": "true",
        "YOUTUBE_API_KEY": "your_youtube_api_key_here"
      }
    }
  }
}

You have a Python-based MCP server that integrates YouTube Data API v3 to help you discover content and retrieve metrics for videos, channels, and playlists. It powers your AI assistant to search, filter, and analyze YouTube data, enabling practical workflows like finding videos by criteria, discovering channels, and pulling key statistics.

How to use

Start the MCP server locally and connect an MCP client or your AI assistant. You can run searches for videos, channels, and playlists, then fetch metrics for specific items by ID. Use the server to build workflows such as: finding high-traffic videos in a topic, discovering active channels, or aggregating metrics for a playlist.

How to install

Prerequisites you need before starting:

Python 3.8 or higher
YouTube Data API v3 key
VSCode with MCP extension (for VSCode usage) or any MCP client that supports the protocol
Required Python packages: google-api-python-client, python-dotenv, pydantic

{
  "mcpServers": {
    "youtube_mcp": {
      "type": "stdio",
      "command": "python",
      "args": ["/path/to/youtube-content-management-mcp/main.py"],
      "env": {
        "YOUTUBE_API_KEY": "your_youtube_api_key_here"
      }
    },
    "youtube_mcp_uv": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/youtube-content-management-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "YOUTUBE_API_KEY": "your_youtube_api_key_here"
      }
    }
  }
}

Additional sections

Environment setup and usage details continue here. You will provide your YouTube API key via environment variables when starting the MCP server so that all tool calls can access YouTube Data API v3 securely.

Security notes

Never commit your API key to version control. Use environment variables and rotate keys regularly. Monitor API usage in the Google Cloud Console and restrict keys to the YouTube Data API v3 to prevent unauthorized access.

Troubleshooting

Common issues include missing API keys, quota limits, or invalid keys. Ensure the API key is set in the environment, verify the key is valid, and check that YouTube Data API v3 is enabled for the project. If quotas are exhausted, wait for resets or request a higher quota in the Google Cloud Console.

Usage notes and limits

The server provides endpoints to search for videos, channels, and playlists and to fetch metrics for each. Be mindful of API quotas, particularly when performing metric-heavy queries.

Available tools

search_videos

Search YouTube for videos with filters for metrics such as view count, like count, and comment count.

search_channels

Find YouTube channels by query and retrieve metrics like subscriber count, total views, and video count.

search_playlists

Search YouTube for playlists matching a query.

get_video_metrics

Retrieve statistics for a specific video by its ID.

get_channel_metrics

Retrieve statistics for a specific channel by its ID.

get_playlist_metrics

Retrieve statistics for a specific playlist by its ID.

Built by

VeilStrat

AI signals for GTM teams