YouTube Studio MCP

Servidor MCP local para metadatos, miniaturas, comentarios y análisis de YouTube.

Documentación

YouTube Studio MCP

Un servidor local de Model Context Protocol (MCP) para gestionar canales de YouTube desde herramientas de IA como Codex, Claude Desktop, Cursor y otros clientes compatibles con MCP.

YouTube Studio MCP permite que tu asistente inspeccione el rendimiento del canal, revise las subidas recientes, actualice los metadatos de los vídeos, suba miniaturas, publique comentarios y lea las analíticas mediante tus propias credenciales de Google OAuth.

YouTube Studio MCP terminal demo

Demo

User: Show my YouTube channel overview and summarize the last 10 uploaded videos.

Assistant uses:
- youtube_auth_status
- youtube_channel_overview
- youtube_list_videos

Result:
The assistant can review recent uploads, public stats, metadata, privacy status, and improvement opportunities.

Consulta Demo para ver un recorrido de configuración.

Características

Lee el perfil del canal autenticado, las estadísticas, la marca y la lista de reproducción de subidas.
Enumera los vídeos recientes con metadatos, estado de privacidad, detalles de contenido y estadísticas públicas.
Actualiza el título, la descripción, las etiquetas, la categoría, el idioma predeterminado y el estado de privacidad de los vídeos.
Sube miniaturas personalizadas desde archivos de imagen locales.
Lee informes de YouTube Analytics del canal y por vídeo.
Publica y enumera comentarios de nivel superior en los vídeos.
Se ejecuta localmente a través de stdio sin backend alojado.
Utiliza únicamente la biblioteca estándar de Python en tiempo de ejecución.

Por qué existe

Los creadores suelen querer ayuda de IA con el trabajo repetitivo de YouTube Studio: auditar metadatos, mejorar el SEO, comparar el rendimiento de los vídeos, preparar descripciones y mantener la coherencia de miniaturas y títulos. Este servidor MCP ofrece a un asistente de IA acceso controlado a esos flujos de trabajo mientras mantiene las credenciales en tu propia máquina.

Requisitos

Python 3.10 o superior.
Una cuenta de Google con acceso al canal de YouTube.
Un proyecto de Google Cloud con:
- YouTube Data API v3 habilitada.
- YouTube Analytics API habilitada.
Un JSON de cliente de aplicación de escritorio de Google OAuth.
Un cliente compatible con MCP.

Inicio rápido

Clona el repositorio:

git clone https://github.com/i1s-abhishek/youtube-studio-mcp.git
cd youtube-studio-mcp

Crea la carpeta local de secretos si no existe:

mkdir -p secrets

Descarga el JSON de cliente de escritorio de Google OAuth y guárdalo como:

secrets/client_secret.json

Autentícate con Google:

python3 scripts/auth.py auth

Configura tu cliente MCP para ejecutar:

python3 scripts/server.py

Consulta Configuración de Google OAuth y Configuración del cliente MCP para ver los pasos detallados.

Configuración de MCP

Ejemplo de configuración stdio:

{
  "mcpServers": {
    "youtube-studio": {
      "command": "python3",
      "args": ["./scripts/server.py"],
      "cwd": "/absolute/path/to/youtube-studio-mcp",
      "env": {
        "YOUTUBE_CLIENT_SECRETS": "./secrets/client_secret.json",
        "YOUTUBE_TOKEN_FILE": "./secrets/token.json"
      }
    }
  }
}

Reemplaza /absolute/path/to/youtube-studio-mcp con la ruta donde clonaste este repositorio.

Herramientas disponibles

Consulta Tools para ver la lista completa de herramientas.

Las herramientas principales incluyen:

youtube_channel_overview
youtube_list_videos
youtube_get_video
youtube_update_video
youtube_upload_thumbnail
youtube_channel_analytics
youtube_video_analytics
youtube_post_comment
youtube_list_comments

Ejemplos de prompts

Show my YouTube channel overview and summarize the last 10 uploads.

Review my last 28 days of analytics and suggest what I should improve next.

Update this video's title, description, tags, and language.

Upload this local thumbnail image to video VIDEO_ID.

Ámbitos de OAuth

Este servidor solicita:

https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl
https://www.googleapis.com/auth/youtube.readonly
https://www.googleapis.com/auth/yt-analytics.readonly

Estos ámbitos son amplios porque el servidor admite acciones de lectura y escritura en YouTube Studio. Ejecuta este servidor únicamente en máquinas de confianza.

Notas de seguridad

No confirmes secrets/client_secret.json.
No confirmes secrets/token.json.
Revisa las llamadas a herramientas antes de permitir actualizaciones de metadatos o comentarios.
Mantén una copia de seguridad de títulos, descripciones y etiquetas importantes antes de realizar actualizaciones masivas.

Verificación

Antes de publicar, se verificó este repositorio para confirmar que solo se rastrea secrets/.gitkeep en secrets/; los archivos OAuth reales como secrets/client_secret.json y secrets/token.json son ignorados por git.

Temas del repositorio

Temas sugeridos para GitHub:

mcp, model-context-protocol, youtube, youtube-api, youtube-analytics, youtube-studio, ai-tools, creator-tools, python

Publicación

Los mantenedores pueden publicar o actualizar el repositorio de GitHub con:

scripts/publish_github.sh i1s-abhishek youtube-studio-mcp

El script crea un repositorio público de GitHub si es necesario, envía main y aplica los temas de descubrimiento relevantes.

Usa Launch Copy al enviar este proyecto a directorios de MCP o publicarlo en plataformas sociales.

Contribuciones

Las contribuciones son bienvenidas. Consulta CONTRIBUTING.md.

Seguridad

Por favor, lee SECURITY.md antes de usarlo con un canal de producción.

Licencia

MIT. Consulta LICENSE.

YouTube Studio MCP

Documentación