claude-code-youtube-mcp

MCP server that brings YouTube to Claude Code — video transcripts, search, metadata, channel info, playlists, comments, trending videos, engagement analytics, chapter extraction, SponsorBlock integration, and most-replayed heatmaps. Uses the YouTube Data API v3, youtube-transcript, and SponsorBlock.

1. Go to Google Cloud Console
2. Create a project (or select an existing one)
3. Enable the YouTube Data API v3:

• Go to API Library
• Click Enable

1. Create an API key:

• Go to Credentials
• Click Create Credentials > API key

1. Copy the key (you'll need it in Step 3)

• Node.js 18+ - Download here
• Claude Code CLI - Installation guide

git clone https://github.com/wynandw87/claude-code-youtube-mcp.git
cd claude-code-youtube-mcp

macOS / Linux / Windows:

npm install

> Note: Dependencies are installed and the server is built automatically in one step.

Choose your install scope:

| Scope | Flag | Who can use it | |-------|------|----------------| | User (recommended) | -s user | You, in any project | | Project | -s project | Anyone who clones this repo | | Local | -s local | Only in current directory |

Replace YOUR_API_KEY with your actual YouTube Data API key, and use the full path to dist/index.js.

> Tip: To get the full path, run this from the cloned directory: > - macOS/Linux: echo "$(pwd)/dist/index.js" > - Windows: echo %cd%\dist\index.js

macOS / Linux:

claude mcp add -s user yout