YouTube MCP Server

MCP-Server, der YouTube zu Claude Code bringt — Videotranskripte, Suche, Metadaten, Kanalinformationen, Playlists, Kommentare, Trend-Videos, Engagement-Analysen, Kapitel-Extraktion, SponsorBlock-Integration und Most-Replayed-Heatmaps. Verwendet die YouTube Data API v3, youtube-transcript und SponsorBlock.

Schnellstart

Schritt 1: API-Schlüssel abrufen

1. Gehe zu Google Cloud Console

2. Erstelle ein Projekt (oder wähle ein vorhandenes aus)

3. Aktiviere die YouTube Data API v3:

   • Gehe zur API-Bibliothek

   • Klicke auf Aktivieren

4. Erstelle einen API-Schlüssel:

   • Gehe zu Anmeldedaten

   • Klicke auf Anmeldedaten erstellen > API-Schlüssel

5. Kopiere den Schlüssel (du brauchst ihn in Schritt 3)

Schritt 2: Voraussetzungen installieren

• Node.js 18+ - Hier herunterladen

• Claude Code CLI - Installationsanleitung

Schritt 3: MCP-Server installieren

3.1 Repository klonen

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

3.2 Abhängigkeiten installieren

macOS / Linux / Windows:

npm install

Hinweis: Die Abhängigkeiten werden installiert und der Server automatisch in einem Schritt erstellt.

3.3 Bei Claude Code registrieren

Wähle deinen Installationsbereich:

Ersetze YOUR_API_KEY durch deinen tatsächlichen YouTube-Data-API-Schlüssel und verwende den vollständigen Pfad zu dist/index.js.

Tipp: Um den vollständigen Pfad zu erhalten, führe Folgendes im geklonten Verzeichnis aus:

• macOS/Linux: echo "$(pwd)/dist/index.js"

• Windows: echo %cd%\dist\index.js

macOS / Linux:

claude mcp add -s user youtube -e YOUTUBE_API_KEY=YOUR_API_KEY -- node /full/path/to/dist/index.js

Windows (CMD):

claude mcp add -s user youtube -e "YOUTUBE_API_KEY=YOUR_API_KEY" -- node "C:\full\path\to\dist\index.js"

Windows (PowerShell):

claude mcp add -s user youtube -e "YOUTUBE_API_KEY=YOUR_API_KEY" '--' node "C:\full\path\to\dist\index.js"

Alternative: npm-Helfer verwenden (wenn der API-Schlüssel in der Umgebung gesetzt ist)

export YOUTUBE_API_KEY=YOUR_API_KEY
npm run install:claude

Schritt 4: Claude Code neu starten

Schließe und öffne Claude Code erneut, damit die Änderungen wirksam werden.

Schritt 5: Installation überprüfen

claude mcp list

Du solltest youtube mit dem Status „Connected“ aufgeführt sehen.

Related MCP server: youtube-research

Funktionen

Transkripte & Untertitel

• Get Transcript (get_transcript) - Ruft vollständige Videotranskripte mit Zeitstempeln ab; unterstützt mehrere Sprachen

• Search Transcript (search_transcript) - Findet mit Zeitstempeln heraus, wo ein Schlüsselwort oder eine Phrase in einem Video vorkommt

• Clean Transcript (get_clean_transcript) - Transkript ohne Sponsorabschnitte, Intros, Outros und Füllwörter, über SponsorBlock entfernt

• Extract Chapters (extract_chapters) - Analysiert Kapitel-Zeitstempel aus Videobeschreibungen

Suche & Entdeckung

• Search Videos (search_videos) - Vollständige YouTube-Suche mit Filtern für Datum, Dauer, Typ und Sortierreihenfolge

• Search Within Channel (search_within_channel) - Suche nach Videos von einem bestimmten Ersteller

• Get Trending Videos (get_trending_videos) - Derzeit im

Hinweis: 5 Tools funktionieren ohne API-Schlüssel (Transkripte, SponsorBlock, Heatmaps, URL-Parsing). Die restlichen 10 benötigen einen Schlüssel für die YouTube Data API v3.

Konfiguration

Umgebungsvariablen

YouTube-API-Kontingent

Die YouTube Data API v3 hat ein tägliches Kontingent von 10.000 Einheiten. Jedes Tool verbraucht eine andere Menge:

Tipp: Suchvorgänge sind am teuersten. Verwende get_channel_videos (1 Einheit) anstelle von search_within_channel (100 Einheiten), wenn du nur aktuelle Uploads benötigst.

Fehlerbehebung

API-Schlüssel korrigieren

Wenn du den falschen API-Schlüssel eingegeben hast, entferne und installiere ihn neu:

claude mcp remove youtube

Dann installiere ihn mit dem Befehl aus Schritt 3.3 oben neu (verwende denselben Scope, mit dem du ursprünglich installiert hast).

MCP-Server wird nicht angezeigt

Prüfe, ob der Server installiert ist:

claude mcp list

Falls er nicht aufgeführt ist, folge Schritt 3, um ihn zu installieren.

Server startet nicht

1. Prüfe, ob dein API-Schlüssel gültig ist in der Google Cloud Console

2. Prüfe, ob die YouTube Data API aktiviert ist:

   • Gehe zur API Library

   • Dort sollte „Aktiviert“ stehen.

3. Prüfe die Node.js-Version (mindestens 18 erforderlich):

   node --version

4. Stelle sicher, dass der Server gebaut wurde – wenn dist/index.js fehlt, führe npm install erneut aus.

Verbindungsfehler

1. Prüfe, ob dist/index.js existiert – wenn nicht, führe npm install aus.

2. Stelle sicher, dass der Pfad absolut ist in deinem Befehl claude mcp add.

3. Starte Claude Code nach jeder Konfigurationsänderung neu.

Kontingent überschritten

Wenn du „quotaExceeded“-Fehler siehst:

• Warte bis Mitternacht (Pacific Time) – das Kontingent wird täglich zurückgesetzt.

• Verwende einen anderen API-Schlüssel.

• Bevorzuge kostengünstige Tools (get_video_metadata mit 1 Einheit) gegenüber Suchtools (100 Einheiten).

Transkript nicht verfügbar

Bei manchen Videos sind Transkripte deaktiviert. Das Tool get_transcript gibt eine klare Fehlermeldung zurück. Versuche:

• Einen anderen Sprachcode (z. B. lang: "es")

• Automatisch generierte Untertitel sind möglicherweise verfügbar, auch wenn keine manuellen vorhanden sind.

Timeout-Fehler

Erhöhe die Umgebungsvariable YOUTUBE_TIMEOUT für langsame Verbindungen:

claude mcp add -s user youtube -e YOUTUBE_API_KEY=YOUR_KEY -e YOUTUBE_TIMEOUT=60000 -- node /path/to/dist/index.js

Aktuelle Konfiguration anzeigen

claude mcp list

Mitwirken

Pull-Requests willkommen! Bitte halte es einfach und anfängerfreundlich.

Lizenz

MIT

Für die Claude Code-Community gemacht.