YouTube MCP Server

MCP-Server, der YouTube in Claude Code bringt – Videotranskripte, Suche, Metadaten, Kanalinformationen, Playlists, Kommentare, Trendvideos, 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 zur Google Cloud Console

2. Erstelle ein Projekt (oder wähle ein bestehendes 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: Den 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 wird 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 aus dem 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: Den 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 Claude Code und öffne es erneut, damit die Änderungen wirksam werden.

Schritt 5: Installation überprüfen

claude mcp list

Du solltest youtube mit dem Status „Verbunden“ aufgelistet sehen.

Related MCP server: youtube-research

Funktionen

Transkripte & Untertitel

• Transkript abrufen (get_transcript) – Vollständige Videotranskripte mit Zeitstempeln abrufen; unterstützt mehrere Sprachen

• Transkript durchsuchen (search_transcript) – Finden, wo ein Schlüsselwort oder eine Phrase in einem Video mit Zeitstempeln vorkommt

• Bereinigtes Transkript (get_clean_transcript) – Transkript ohne Sponsoren, Intros, Outros und Füllwörter, entfernt über SponsorBlock

• Kapitel extrahieren (extract_chapters) – Kapitelzeitstempel aus Videobeschreibungen parsen

Suche & Entdeckung

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

• Im Kanal suchen (search_within_channel) – Nach Videos von einem bestimmten Ersteller suchen

• Trendvideos abrufen (get_trending_videos) – Aktuell trendende Videos nach Region und Kategorie

• Kanalvideos abrufen (get_channel_videos) – Aktuelle Uploads von einem Kanal, sortiert nach Datum oder Aufrufen

Video- & Kanalinformationen

• Video-Metadaten (get_video_metadata) – Titel, Beschreibung, Dauer, Aufrufe, Likes, Tags und mehr

• Kanalinformationen (get_channel_info) – Abonnentenzahl, Videoanzahl, Beschreibung, Land

• Playlist-Elemente (get_playlist_items) – Alle Videos in einer Playlist mit Positionen und Metadaten

Analysen & Engagement

• Engagement berechnen (calculate_engagement) – Like-Rate, Kommentar-Rate und Engagement-Rate aus öffentlichen Statistiken

• Most Replayed (get_most_replayed) – Heatmap-Daten, die anzeigen, welche Teile Zuschauer am häufigsten erneut ansehen

• Videokommentare (get_video_comments) – Top-Kommentare mit Like- und Antwortzahlen

Hinweis: 5 Tools funktionieren ohne API-Schlüssel (Transkripte, SponsorBlock, Heatmaps, URL-Parsing). Die restlichen 10 erfordern einen YouTube Data API v3-Schlüssel.

Konfiguration

Umgebungsvariablen

YouTube-API-Kontingent

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

Tipp: Suchoperationen 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 den Server neu:

claude mcp remove youtube

Installiere dann mit dem Befehl aus Schritt 3.3 oben neu (verwende denselben Bereich, mit dem du ursprünglich installiert hast).

MCP-Server wird nicht angezeigt

Prüfe, ob der Server installiert ist:

claude mcp list

Wenn er nicht aufgelistet ist, folge Schritt 3, um ihn zu installieren.

Server startet nicht

1. Überprüfe, ob dein API-Schlüssel unter Google Cloud Console gültig ist

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

   • Gehe zur API-Bibliothek

   • Dort sollte „Enabled“ stehen

3. Prüfe die Node.js-Version (benötigt 18+):

   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, dass dist/index.js vorhanden ist — wenn nicht, führe npm install aus

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

3. Starte Claude Code neu nach allen Konfigurationsänderungen

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 Such-Tools (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 erzeugte 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 sind willkommen! Bitte halte es einfach und einsteigerfreundlich.

Lizenz

MIT

Erstellt für die Claude Code-Community