mcp-google-slides

Google Slides MCP

Inglés | Русский

A1 Google Slides MCP permite que una aplicación de IA cree y edite presentaciones de Google Slides en lenguaje natural. Redacta una presentación, añade y reorganiza diapositivas, escribe y da estilo al texto, coloca formas, imágenes y tablas, conserva las notas del orador, revisa comentarios y exporta el resultado como PDF o PPTX.

Utiliza la API de Google Slides con tu cuenta de Google. Todo lo que hay dentro de una presentación se aborda mediante identificadores de objeto explícitos, y hace explícitos los límites de la API de Slides en lugar de dar a entender que todas las tareas de presentación son posibles.

• 32 herramientas. Inspecciona presentaciones y páginas, edita diapositivas, texto, formas, imágenes y tablas, gestiona notas del orador y comentarios, genera miniaturas y exporta archivos.
• Se conecta desde la conversación. Di "conectar Google Slides": el servidor te guía a través del cliente OAuth, captura la redirección de Google en 127.0.0.1 con PKCE y guarda los tokens él mismo — sin archivos de configuración, sin reinicios.
• Las ediciones son atómicas. Los cambios viajan en el batchUpdate de la API: una solicitud no válida invalida todo el lote, por lo que una presentación nunca queda a medio editar.
• Tu Drive permanece fuera de alcance. Los comentarios, la exportación y la subida de imágenes locales usan la API de Drive estrictamente para el archivo de presentación único — no hay herramientas para listar, compartir, renombrar o eliminar archivos de Drive.
• Ámbitos de Google mínimos. Necesita presentations; los ámbitos de Drive solo se requieren para imágenes locales, comentarios y exportación.

Comienza con una pregunta de solo lectura:

Muéstrame las diapositivas de la presentación del informe trimestral y qué hay en cada una.

Conectar el servidor · Explorar casos de uso · Abrir documentación técnica

Véalo funcionar en un minuto

Tú: Enumera las diapositivas de la presentación de revisión del tercer trimestre y qué hay en cada una.

Asistente: Muestra un inventario compacto: la posición, el diseño y los elementos de cada diapositiva con su texto visible. No cambia nada.

Tú: Prepara una nueva diapositiva después de la agenda titulada "Hoja de ruta", con las fechas clave en el cuerpo.

Asistente: Muestra la presentación objetivo, el diseño y el texto propuesto, y luego pide confirmación antes de añadirla.

Tú: Confirmo.

Asistente: Añade la diapositiva y rellena sus marcadores de posición. No toca las demás diapositivas.

Contenido

• Inicio rápido
• Qué puedes pedirle que haga
• Cómo cambia una presentación
• Qué puede cambiar
• Cómo obtener acceso
• Configuración
• Datos, límites y trabajo en segundo plano
• Documentación técnica
• Soporte

Inicio rápido

Necesitas Node.js 20+ y una cuenta de Google. No se requieren credenciales en el momento de la instalación — el servidor se conecta desde la conversación.

1. Añade el servidor a tu aplicación de IA.
2. Di "conectar Google Slides": el asistente te guía para crear el cliente OAuth y aprobar el acceso sin editar archivos de configuración.
3. Haz la pregunta de solo lectura anterior.

codex mcp add google-slides \
  -- npx -y @a1-x-tech/mcp-google-slides@latest

codex mcp list

claude mcp add \
  --transport stdio --scope user google-slides \
  -- npx -y @a1-x-tech/mcp-google-slides@latest

claude mcp list

{
  "mcpServers": {
    "google-slides": {
      "command": "npx",
      "args": ["-y", "@a1-x-tech/mcp-google-slides@latest"]
    }
  }
}

{
  "mcpServers": {
    "google-slides": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@a1-x-tech/mcp-google-slides@latest"]
    }
  }
}

{
  "servers": {
    "google-slides": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@a1-x-tech/mcp-google-slides@latest"]
    }
  }
}

Qué puedes pedirle que haga

Inspeccionar una presentación

• Enumera las diapositivas de esta presentación y qué hay en cada una.
• Lee las notas del orador de la diapositiva 5.
• Genera una miniatura de la diapositiva de título.

Crear y reorganizar diapositivas

• Crea una presentación para la revisión del tercer trimestre.
• Añade una diapositiva "Hoja de ruta" después de la agenda, duplica la diapositiva de plantilla, mueve el resumen al final.
• Inserta una imagen desde una URL o un archivo local, añade una tabla de 4×3, crea un cuadro de texto o un rectángulo redondeado con su leyenda.

Escribir y pulir texto

• Pon este texto en el marcador de posición del título y haz que la fecha límite esté en negrita y roja.
• Reemplaza "Q2" por "Q3" en toda la presentación.
• Reescribe las notas del orador de la diapositiva 3 para que sean más breves.

Revisar y entregar

• Enumera los hilos de comentarios abiertos y responde al primero, resolviéndolo.
• Elimina la diapositiva de borrador que ya no necesitamos.
• Exporta la presentación como PDF o PPTX para alguien sin acceso a Google.

Cómo cambia una presentación

1. create_presentation crea una presentación con una diapositiva de título; solo se respeta el título en la creación.
2. Todo lo que hay dentro de una presentación — diapositivas, formas, imágenes, tablas — se aborda mediante identificadores de objeto. list_slides es el inventario compacto con el que empezar antes de cualquier edición.
3. Las ediciones pasan por el batchUpdate atómico de la API: una solicitud no válida invalida todo el lote, por lo que nada se aplica a medias.
4. Las entradas de las herramientas están en puntos; la API almacena EMU (1 pt = 12700 EMU). El servidor convierte en ambos sentidos.

La API de Slides no puede eliminar, renombrar ni compartir el archivo de presentación — esas son operaciones de archivos de Drive fuera del alcance de este servidor. No puede importar un tema (solo instanciar diseños que la presentación ya tenga) y no puede anclar un comentario nuevo a una diapositiva específica. La exportación está limitada a 10 MB, y las URL de miniaturas caducan después de unos 30 minutos.

Qué puede cambiar

El cliente de IA controla los avisos de confirmación. El servidor marca las herramientas de lectura, escritura y destructivas para que el cliente pueda distinguir una inspección de un cambio en vivo.

Cómo obtener acceso

Google Slides requiere OAuth 2.0; una clave de API no es suficiente. Hay dos formas de acceder, y la primera no necesita archivos de configuración.

Conectar desde el chat (recomendado)

Di "conectar Google Slides" y el asistente ejecuta el flujo contigo:

1. setup_instructions imprime la lista de verificación: crea o selecciona un proyecto de Google Cloud, habilita la API de Google Slides, configura la pantalla de consentimiento y crea un cliente OAuth de aplicación de escritorio.
2. Descarga el JSON de ese cliente ("Descargar JSON") y dale al asistente su ruta — set_client lo almacena solo para el propietario. El secreto nunca pasa por la conversación.
3. start_login devuelve un enlace de consentimiento de Google. Ábrelo en esta máquina y aprueba; el código vuelve a un listener de un solo uso en 127.0.0.1 (PKCE), nunca a través del chat.
4. finish_login intercambia el código y guarda los tokens en ~/.config/mcp-google-slides/credentials.json (modo 0600).

Los tokens se releen en cada llamada, por lo que la conexión funciona de inmediato — sin reiniciar la aplicación de IA. auth_status muestra qué está conectado, logout revoca y elimina.

Variables de entorno (CI, instalaciones desatendidas)

1. Crea o selecciona un proyecto de Google Cloud y habilita la API de Google Slides. Habilita también la API de Google Drive si quieres comentarios, exportación o subida de imágenes locales.

2. Configura la pantalla de consentimiento de OAuth y crea un cliente OAuth de aplicación de escritorio.

3. Autoriza la cuenta de Google que posee o puede editar las presentaciones. El Playground de OAuth 2.0 puede obtener el token de actualización cuando Usar tus propias credenciales OAuth está habilitado.

4. Solicita los ámbitos:

   https://www.googleapis.com/auth/presentations
   https://www.googleapis.com/auth/drive.file
   

   presentations cubre todas las lecturas y escrituras de Slides. drive.file cubre la subida de imágenes locales más comentarios y exportación en presentaciones creadas a través de esta aplicación; solicita el https://www.googleapis.com/auth/drive más amplio en su lugar cuando necesites comentarios o exportación en presentaciones arbitrarias.

Los tokens de actualización de OAuth en modo de prueba pueden caducar después de siete días. Publica la aplicación OAuth, o usa una aplicación interna en un dominio de Workspace, cuando necesites acceso de larga duración. Trata el secreto del cliente y el token de actualización como contraseñas.

Configuración

Cada variable es opcional — sin ninguna de ellas el servidor se conecta desde el chat.

* Proporciona el trío OAuth o un token de acceso.

Datos, límites y trabajo en segundo plano

• Las solicitudes van a Google Slides. El servidor local actualiza los tokens OAuth de Google y llama a la API de Slides; los comentarios, la exportación y la subida de imágenes locales viajan por la API de Drive, limitados al archivo de presentación único. Su telemetría anónima contiene un ID de instalación, versión del paquete, cliente de IA y versiones de plataforma, y nombres de herramientas — nunca tokens OAuth, contenido de presentaciones, argumentos de herramientas o avisos. Establece ASKADS_TELEMETRY=0 para optar por no participar.
• Google aplica límites de velocidad. En 429, el servidor usa retroceso; las lecturas también se reintentan después de errores de red y 5xx, mientras que las escrituras no se reproducen después de una falla incierta. Las miniaturas cuentan contra una cuota de lectura más costosa.
• No hay sondeo en segundo plano. El servidor solo se ejecuta cuando se le llama. Nada vigila una presentación entre llamadas; si tu aplicación de IA admite tareas programadas, puede revisar una presentación periódicamente.

Documentación técnica

• Catálogo de capacidades de MCP — páginas orientadas a tareas para cada herramienta.
• Todas las herramientas y entradas
• Documentación de desarrollo
• Documentación de publicación
• Referencia de la API de Google Slides

Soporte

¿Encontraste un error o necesitas un escenario? Crea un issue o escribe en Telegram.

¡Llegaste al final!