Skip to main content
Glama
youtube-mcp-server

youtube-mcp-server

by nyagera

youtube-mcp-server

Serveur MCP (Model Context Protocol) exposant tes données YouTube personnelles (chaîne, vidéos, analytics) comme outils utilisables depuis ChatGPT, Claude, ou tout autre client compatible MCP.

Outils exposés

  • get_channel_stats — abonnés, vues totales, nombre de vidéos

  • list_my_videos — dernières vidéos publiées

  • get_video_analytics — vues, likes, durée de visionnage sur une période

  • get_audience_retention — courbe de rétention, timestamps et principales chutes d'une vidéo

  • search_my_videos — recherche dans tes propres vidéos

  • get_search_keywords — requêtes YouTube Search qui apportent des vues

  • get_search_traffic_trend — évolution quotidienne du trafic provenant de YouTube Search

  • get_audience_demographics — répartition de l'audience par âge et genre

Analyse de la rétention

get_audience_retention interroge une vidéo à la fois avec la dimension elapsedVideoTimeRatio et les métriques audienceWatchRatio et relativeRetentionPerformance. La réponse contient normalement jusqu'à 100 points proportionnels, leur timestamp calculé à partir de la durée de la vidéo, ainsi que les dix baisses les plus fortes entre deux segments consécutifs.

Paramètres requis :

  • videoId — identifiant YouTube de la vidéo

  • startDate — début de la période au format YYYY-MM-DD

  • endDate — fin de la période au format YYYY-MM-DD

Pour rapprocher les baisses du script, utiliser timestamp ou elapsedSeconds avec une transcription horodatée et examiner également les secondes qui précèdent chaque baisse.

Related MCP server: YouTube Current Data MCP

Installation

npm install

Configuration

  1. Les 4 premières variables d'environnement (GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, GOOGLE_REDIRECT_URI, MCP_AUTH_TOKEN) doivent déjà être configurées dans Vercel (Settings > Environment Variables).

  2. Obtenir le refresh token (une seule fois) :

    • Déploie ce projet sur Vercel

    • Visite https://<ton-domaine>.vercel.app/api/oauth/start

    • Connecte-toi avec ton compte Google (celui lié à ta chaîne YouTube)

    • Accepte les permissions demandées

    • Copie le refresh_token affiché sur la page de callback

    • Ajoute-le comme variable d'environnement YOUTUBE_REFRESH_TOKEN dans Vercel, puis redéploie le projet

Connexion depuis ChatGPT / Claude

Ajoute un connecteur MCP personnalisé avec :

  • URL : https://<ton-domaine>.vercel.app/api/mcp

  • Header d'authentification : Authorization: Bearer <ton MCP_AUTH_TOKEN>

Sécurité

  • Ne commite jamais de fichier .env contenant de vraies valeurs (voir .env.example pour la liste des variables nécessaires)

  • Le MCP_AUTH_TOKEN protège l'accès à /api/mcp — ne le partage avec personne

  • Le refresh_token n'est affiché qu'une seule fois lors du premier flow OAuth

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Enables Claude to control a YouTube channel through MCP, including uploading and editing videos, scheduling releases, and reading channel and video analytics via official APIs.
      8
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to interact with YouTube channels, providing analytics, video metadata updates, transcript extraction, and comment management through official Google APIs with OAuth 2.0.
      MIT