mcp-registry/mcp-youtube

    ==================
      
       /// MCP ///
      /// MCP ///
        
    ==================
        
    [server:online]
    [protocol:ready]

mcp-youtube

by anaisbetts

A Model-Context Protocol server that uses yt-dlp to fetch YouTube subtitles and expose them to Claude/other MCP-compatible LLMs.

402
48
Specialized
GitHubDocumentation

Installation

Prerequisites:
1. Node.js ≥ 18 and npm (or yarn / pnpm)
2. A Google Cloud project with YouTube Data API enabled
3. A YouTube API key or OAuth 2.0 client credentials
Steps:
1. Clone the repository
git clone https://github.com/anaisbetts/mcp-youtube.git cd mcp-youtube
2. Install dependencies
# with npm npm install # ‑ or ‑ yarn install
3. Configure environment variables. Create a .env file in the project root:
YOUTUBE_API_KEY=YOUR_YOUTUBE_DATA_API_KEY # For OAuth flow instead of API key: GOOGLE_CLIENT_ID=XXX.apps.googleusercontent.com GOOGLE_CLIENT_SECRET=YOUR_SECRET GOOGLE_REDIRECT_URI=http://localhost:3000/oauth2callback
4. (Optional) Adjust server port or MCP settings in config.json or via env vars:
PORT=3000 MCP_MODEL_PATH=./models
5. Start the server in development mode
npm run dev # or production npm run build && npm start
6. Verify: open http://localhost:3000/health or http://localhost:3000/mcp/describe to confirm the MCP instance is running.

Documentation

License: MIT License
Updated 7/15/2025