Google Slides MCP Server

Este proceso es un servidor MCP para la API de Google Slides. Un host se comunica con él mediante stdio. La primera ejecución abre un navegador. Pegas un ID de cliente de escritorio y un secreto de cliente. A continuación se muestra el consentimiento de Google. Las ejecuciones posteriores leen el almacén de tokens.

Requisitos previos

• Node.js 20 o posterior

• Un proyecto de Google Cloud con la API de Google Slides habilitada

• Un ID de cliente y un secreto de cliente OAuth de escritorio

No necesitas un token de actualización. No necesitas variables de entorno del proceso.

Related MCP server: MCP Google Sheets Server

Claude Code

1. Crea un cliente OAuth de escritorio. Usa los pasos de la plataforma Google Auth que se indican a continuación.

2. En Claude Code ejecuta:

/plugin marketplace add matteoantoci/claude-plugins
/plugin install google-slides-mcp@matteoantoci-plugins

3. Ejecuta /reload-plugins si Claude lo solicita.

4. El primer inicio abre un navegador. Pega el ID de cliente y el secreto de cliente. Completa el consentimiento de Google.

Las sesiones posteriores leen el almacén de tokens. Sin JSON de host. Sin variables de entorno.

Otros hosts

1. Clona este repositorio.

2. Ejecuta npm install.

3. Ejecuta npm run build.

4. Crea un cliente OAuth de escritorio en Google Cloud Console:

   • Abre la plataforma Google Auth.

   • Si la página indica que la plataforma no está configurada, haz clic en Comenzar.

   • Nombre de la aplicación: Google Slides MCP. Correo electrónico de asistencia al usuario: tu dirección.

   • Audiencia: Externa.

   • Correo electrónico de contacto: tu dirección. Acepta la política. Haz clic en Crear.

   • Abre Audiencia. Añade tu Gmail como usuario de prueba.

   • Abre Acceso a datos. Añade https://www.googleapis.com/auth/presentations y https://www.googleapis.com/auth/drive.readonly. Guarda.

   • Abre Clientes. Haz clic en Crear cliente. Tipo de aplicación: Aplicación de escritorio. Nombre: Google Slides MCP Desktop. Haz clic en Crear.

   • Copia el ID de cliente y el secreto de cliente.

5. Ejecuta npm run start. Pega el ID de cliente y el secreto de cliente. Completa el consentimiento de Google. Después, detén el proceso.

6. Apunta el host a node /path/to/google-slides-mcp/build/index.js. No configures variables de entorno.

Ejemplo de configuración de host:

"google-slides-mcp": {
  "transportType": "stdio",
  "command": "node",
  "args": [
    "/path/to/google-slides-mcp/build/index.js"
  ]
}

Reemplaza la ruta con el build/index.js compilado en tu máquina.

Primer inicio

El proceso abre una página de loopback.

• Si el almacén no tiene ID de cliente ni secreto de cliente, pega esos dos valores.

• Continúa con el consentimiento de Google.

• Cierra la página de éxito.

El proceso escribe la credencial de Google en el almacén de tokens. Primero intenta usar el llavero del sistema operativo. Usa ~/.config/google-slides-mcp/credential.json si el llavero no está disponible. El modo de archivo es 0600.

Las ejecuciones posteriores usan el almacén. Sin navegador.

GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET y GOOGLE_REFRESH_TOKEN pueden sobrescribir un campo. Nunca son obligatorias. Si las variables de entorno proporcionan un campo que falta, el proceso escribe la credencial combinada en el almacén.

Ejecutar sin un host

npm run start

El proceso escucha en stdio. Stderr imprime Google Slides MCP server running and connected via stdio.

Herramientas disponibles

• create_presentation: Crea una nueva presentación de Google Slides.

  • Entrada:

    • title (string, obligatorio): El título de la nueva presentación.

  • Salida: Objeto JSON que representa los detalles de la presentación creada.

• get_presentation: Recupera los detalles de una presentación existente.

  • Entrada:

    • presentationId (string, obligatorio): El ID de la presentación que se va a recuperar.

    • fields (string, opcional): Una máscara de campos (p. ej., "slides,pageSize") para limitar los datos devueltos.

  • Salida: Objeto JSON que representa los detalles de la presentación.

• batch_update_presentation: Aplica una serie de actualizaciones a una presentación. Este es el método principal para modificar diapositivas (añadir texto, formas, imágenes, crear diapositivas, etc.).

  • Entrada:

    • presentationId (string, obligatorio): El ID de la presentación que se va a actualizar.

    • requests (array, obligatorio): Un array de objetos de solicitud que definen las actualizaciones. Consulta la documentación de la API de Google Slides batchUpdate para conocer la estructura de cada solicitud individual.

    • writeControl (object, opcional): Controla la ejecución de las solicitudes de escritura (p. ej., mediante IDs de revisión).

  • Salida: Objeto JSON que representa el resultado de la actualización por lotes.

• get_page: Recupera los detalles de una página (diapositiva) específica dentro de una presentación.

  • Entrada:

    • presentationId (string, obligatorio): El ID de la presentación que se va a recuperar.

    • pageObjectId (string, obligatorio): El ID de objeto de la página (diapositiva) que se va a recuperar.

  • Salida: Objeto JSON que representa los detalles de la página.

• summarize_presentation: Extrae y formatea todo el contenido de texto de una presentación para facilitar su resumen.

  • Entrada:

    • presentationId (string, obligatorio): El ID de la presentación que se va a resumir.

    • include_notes (boolean, opcional): Si se deben incluir las notas del orador en el resumen. El valor predeterminado es false.

  • Salida: Objeto JSON que contiene:

    • title: El título de la presentación

    • slideCount: Número total de diapositivas

    • lastModified: Información de revisión

    • slides: Array de objetos de diapositiva que contiene:

      • slideNumber: Posición en la presentación

      • slideId: ID de objeto de la diapositiva

      • content: Todo el texto extraído de la diapositiva

      • notes: Notas del orador (si se solicitan y están disponibles)