Skip to main content
Glama

Prepara tu Google Classroom hablando con Claude, como si se lo pidieras a un compañero.

Checks npm 26 herramientas 33 pruebas Licencia MIT

Instalar · Qué puede hacer · Si algo falla · Privacidad · Guía paso a paso


Qué puede hacer

Háblale como a un compañero. Algunos ejemplos:

Para…

Pídeselo así

Saber qué tienes pendiente

«¿Qué tengo en borrador o programado? ¿Qué entregas vencen esta semana?»

Crear tareas

«Crea la tarea Práctica 5, 10 puntos, para el viernes a las 23:59, en el tema Unidad 3.»

Fichas para cada alumno

«Adjunta la ficha Práctica 5 de mi Drive como copia para cada alumno.»

Trabajo en grupo

«Adjunta el documento del proyecto en edición compartida para toda la clase.»

Preguntas rápidas

«Haz una pregunta tipo test: ¿Qué componente almacena energía? Opciones: resistencia, condensador, diodo.»

Subir archivos

«Sube Apuntes tema 4.pdf de Descargas y publícalo como material en 1º A.»

Formato Google

«Sube Rúbrica.docx convertida a Documento de Google y adjúntala editable.»

Buscar en Drive

«Busca en mi Drive las presentaciones que se llamen electricidad.»

Repetir en varios grupos

«Copia el material Vocabulario a 1º B, 1º C y 1º D.»

Avisar a la clase

«Programa un anuncio para el lunes a las 8:00 recordando traer la calculadora.»

Cambiar fechas

«Retrasa una semana las entregas de las prácticas 8 a 12.»

Related MCP server: classroom-mcp-server

Instalación

Necesitas Claude Desktop (Mac o Windows) y tu cuenta de Google del centro. No hace falta instalar nada más ni abrir la Terminal.

1. Crea tu llave de Google. Google pide que cada docente cree su propia llave gratuita para que Claude pueda entrar en su Classroom. La guía paso a paso te lleva directamente a cada pantalla. Al terminar tendrás un archivo client_secret_….json en tu carpeta Descargas: déjalo ahí.

2. Instala la extensión. Descárgala, haz doble clic en el archivo y pulsa Instalar en Claude Desktop.

Si el doble clic no abre Claude, ve a Configuración → Extensiones en Claude Desktop y arrastra el archivo a esa ventana.

3. Conecta tu cuenta. En una conversación nueva, escribe «Conecta Classroom». Se abrirá Google en tu navegador: elige tu cuenta del centro y marca todas las casillas de permisos. Si Google avisa de que la aplicación no está verificada, es normal (la aplicación es tuya): pulsa Configuración avanzada → Ir a Classroom MCP.

Para comprobarlo, pídele: «Lista mis cursos de Classroom».

Un asistente hace los tres pasos contigo: abre cada página de Google, detecta la llave descargada, conecta tu cuenta y lo añade a Claude Desktop y a Claude Code. Necesita Node.js 22 o 24 (versión LTS). En la Terminal (Mac) o PowerShell (Windows):

npx -y google-classroom-mcp-docentes setup

Más opciones en la guía de instalación.

Novedades de la versión 3.1

  • Instalación en un clic en Claude Desktop, sin Node.js ni Terminal.

  • Conexión desde el chat: «Conecta Classroom» y, cuando caduque, «Reconecta Classroom».

  • Resumen de pendientes de todos tus cursos en una sola pregunta.

  • Copia a otros grupos con sus adjuntos, en borrador y en el tema correcto.

  • Preguntas tipo test, búsqueda en Drive y subida de archivos de tu ordenador (hasta 100 MB) con conversión a formato Google.

  • Mensajes claros en español que dicen qué falta y cómo arreglarlo.

Historial completo en el CHANGELOG.

Si algo falla

Pregúntale a Claude «¿Funciona la conexión con Classroom?». Comprobará qué falta y te dirá qué hacer. Los casos más habituales:

Qué pasa

Qué hacer

Deja de funcionar tras unos días

Es normal si tu llave está en modo «Prueba»: Google pide volver a entrar cada 7 días. Dile a Claude «Reconecta Classroom».

Google dice «Esta app está bloqueada»

El administrador de Google de tu centro bloquea aplicaciones externas. Qué pedirle.

Google dice Error 403: access_denied

Falta añadir tu correo como usuario de prueba (apartado D de la guía).

No puede editar una tarea

Google solo deja modificar lo que se creó desde Claude. Lo creado a mano se edita a mano.

¿Otro problema? Consulta la lista completa o abre una consulta.

Lo que no hace

Límite

Por qué

No borra nada

A propósito: borrar se hace a mano en Classroom.

No pone notas ni ve entregas de alumnos

A propósito: no pide permiso para ver datos de alumnos.

No crea cuestionarios de varias preguntas

Classroom admite una pregunta por publicación. Para un examen, adjunta un Google Forms.

No añade archivos a algo ya publicado

Límite de Google. Claude puede crear la publicación de nuevo con todos los adjuntos.

Solo edita lo que ha creado él

Límite de Google: lo creado a mano en Classroom se edita a mano.

Privacidad

  • Todo funciona en tu ordenador, con tu cuenta y tu propia llave. No hay servidores intermedios.

  • Permisos que pide: gestionar los cursos, temas, tareas, materiales y anuncios que impartes; leer tus archivos de Drive para adjuntarlos, y crear archivos cuando le pides subir uno. No pide acceso a notas, entregas ni datos de alumnos.

  • Solo sube archivos de Descargas, Documentos, Escritorio o tus carpetas de nube; nunca de otras partes del ordenador.

  • Retira el acceso cuando quieras en myaccount.google.com/permissions.

Fiabilidad

  • 33 pruebas automáticas en cada cambio, en Node.js 22 y 24, sin tocar cursos reales: inicio de sesión, permisos, fechas en tu hora local, copias entre grupos, subidas de archivos y mensajes de error.

  • Probado con Google real en una cuenta docente con 11 cursos.

  • Revisión de seguridad en cada cambio: búsqueda de secretos con Gitleaks y auditoría de dependencias sin avisos graves.

  • Las herramientas que escriben nunca reintentan solas, para no crear duplicados.

Otras instalaciones

Con npx en cualquier cliente MCP:

{
  "mcpServers": {
    "google-classroom": { "command": "npx", "args": ["-y", "google-classroom-mcp-docentes"] }
  }
}

Comandos: npx -y google-classroom-mcp-docentes setup (asistente), auth (volver a iniciar sesión) y doctor (comprobar sin modificar nada). Desde el código: git clone, npm ci --ignore-scripts, npm run setup.

Configuración

Variable

Para qué

GOOGLE_CLASSROOM_MCP_HOME

Carpeta de la llave y la sesión. Por defecto, ~/.config/google-classroom-mcp-docentes.

GOOGLE_CREDENTIALS_PATH, GOOGLE_TOKEN_PATH

Rutas exactas de la llave y de la sesión.

GOOGLE_CLASSROOM_UPLOAD_DIRS

Carpetas desde las que se permite subir archivos, separadas por : (; en Windows).

Las 26 herramientas

Área

Herramientas

Conexión

classroom_status, classroom_connect

Cursos

classroom_list_courses, classroom_search_courses, classroom_get_course, classroom_update_course, classroom_get_overview

Temas

classroom_list_topics, classroom_get_topic, classroom_create_topic, classroom_patch_topic

Tareas y preguntas

classroom_list_assignments, classroom_get_assignment, classroom_create_assignment, classroom_patch_assignment, classroom_copy_post

Materiales

classroom_list_materials, classroom_get_material, classroom_create_material, classroom_patch_material

Anuncios

classroom_list_announcements, classroom_post_announcement, classroom_patch_announcement

Drive y Slides

drive_search_files, drive_upload_file, slides_get_presentation

Los adjuntos de Drive aceptan shareMode: VIEW (solo lectura, por defecto), EDIT (un archivo compartido) o STUDENT_COPY (copia para cada alumno; solo en tareas).

Desarrollo

npm ci --ignore-scripts
npm test             # compila y ejecuta las pruebas, sin conexión a Google
npm run build:mcpb   # genera build/google-classroom-docentes.mcpb

Al publicar una etiqueta v*, GitHub Actions genera la extensión y la adjunta a la release. Más detalles en CONTRIBUTING.md.

Créditos

Basado en pengusto/google-classroom-mcp y en el trabajo de Adrià Santacreu i Giménez. Licencia MIT.

Available Tools

26 tools
classroom_connectA

Connect or reconnect Google Classroom without a terminal: picks up the credentials file from the Downloads folder if needed and opens Google sign-in in the teacher's browser. Use it for first-time setup and whenever the sign-in has expired.

Inputs: no named parameters.

classroom_copy_postA

Copy an assignment or a material to other courses (for example the same unit for several groups). Copies are always created as DRAFT with the same title, instructions, points and attachments; the topic is matched by name and created if missing. Copies made here stay editable by this app.

Inputs: id (required), kind (required), sourceCourseId (required), targetCourseIds (required), +3 more.

classroom_create_assignmentC

Create an assignment, a short-answer question or a multiple-choice question (one question with choices) with optional attachments, due date, and topic.

Inputs: title (required), courseId (required), state, choices, +8 more.

classroom_create_materialC

Create a study material post with optional attachments and topic.

Inputs: title (required), courseId (required), state, topicId, +3 more.

classroom_create_topicB

Create a new topic/unit in a course.

Inputs: name (required), courseId (required).

classroom_get_assignmentA
Read-only

Get full details of a specific assignment by ID.

Inputs: id (required), courseId (required).

classroom_get_courseA
Read-only

Get full details of a specific course by ID.

Inputs: courseId (required).

classroom_get_materialA
Read-only

Get full details of a specific course material by ID.

Inputs: id (required), courseId (required).

classroom_get_overviewA
Read-only

One-call planning summary across the courses the teacher teaches: unpublished drafts (count plus up to 20 per course), posts scheduled for later and assignments due in the coming days. Use it for questions like "what do I have pending this week?" instead of listing each course.

Inputs: courseIds, daysAhead.

classroom_get_topicB
Read-only

Get details of a specific topic by ID.

Inputs: id (required), courseId (required).

classroom_list_announcementsA
Read-only

List announcements for a course. Returns one page as {items, nextPageToken}; continue until nextPageToken is null.

Inputs: courseId (required), fullData, pageSize, pageToken, +1 more.

classroom_list_assignmentsA
Read-only

List coursework (assignments/questions) for a course. Supports filtering by state. Returns one page as {items, nextPageToken}; continue until nextPageToken is null.

Inputs: courseId (required), fullData, pageSize, pageToken, +1 more.

classroom_list_coursesA
Read-only

List all Google Classroom courses. Supports filtering by state (ACTIVE, ARCHIVED, PROVISIONED). Returns one page as {items, nextPageToken}; continue until nextPageToken is null.

Inputs: fullData, pageSize, pageToken, courseStates.

classroom_list_materialsA
Read-only

List all non-graded materials for a course. Returns one page as {items, nextPageToken}; continue until nextPageToken is null.

Inputs: courseId (required), fullData, pageSize, pageToken, +1 more.

classroom_list_topicsA
Read-only

List all topics in a course. Returns one page as {items, nextPageToken}; continue until nextPageToken is null.

Inputs: courseId (required), fullData, pageSize, pageToken.

classroom_patch_announcementB

Edit an existing announcement.

Inputs: id (required), courseId (required), updateMask (required), text, +2 more.

classroom_patch_assignmentC

Update specific fields of an existing assignment using updateMask.

Inputs: id (required), courseId (required), updateMask (required), state, +7 more.

classroom_patch_materialC

Update fields of an existing material post.

Inputs: id (required), courseId (required), updateMask (required), state, +4 more.

classroom_patch_topicC

Rename or update a topic.

Inputs: id (required), name (required), courseId (required).

classroom_post_announcementC

Post an announcement to the course stream.

Inputs: text (required), courseId (required), state, scheduledTime.

classroom_search_coursesA
Read-only

Search courses by name or section (client-side filter, case-insensitive). Returns one page as {items, nextPageToken}; continue until nextPageToken is null.

Inputs: query (required), fullData, pageSize, pageToken.

classroom_statusA
Read-only

Check whether Google Classroom is connected. If it is not, returns what is missing and the exact next step to tell the teacher. Call this first when the teacher asks whether the connection works or when another tool reports it is not connected.

Inputs: no named parameters.

classroom_update_courseC

Update course fields (name, section, description, room, state). State can be ACTIVE or ARCHIVED.

Inputs: courseId (required), name, room, state, +2 more.

drive_search_filesA
Read-only

Find files in the teacher's Google Drive (including shared drives) by words in the name, by type or inside a folder, newest first. Use the returned id as a driveFile attachment. Returns one page as {items, nextPageToken}; continue until nextPageToken is null.

Inputs: type, query, folderId, fullData, +2 more.

drive_upload_fileA

Upload a file to Google Drive and return its Drive ID and URL, ready to attach. Prefer localPath for a file on the teacher's computer (Downloads, Documents, Desktop or a cloud-drive folder; up to 100 MB). base64Content is for small generated files (up to 5 MiB).

Inputs: name, folderId, mimeType, localPath, +2 more.

slides_get_presentationA
Read-only

Read a Google Slides presentation by ID, including its slide text and structure.

Inputs: presentationId (required).

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 26 tools

    Disambiguation4/5

    Most tools target a distinct resource+action (courses, assignments, materials, announcements, topics each have their own get/list/create/patch), and descriptions clarify the graded-vs-non-graded split. The main overlap is classroom_search_courses vs classroom_list_courses, which do nearly the same thing with one being a client-side name filter, and classroom_copy_post overlaps partly with classroom_create_assignment/create_material.

    Naming Consistency4/5

    Strong classroom_verb_noun pattern (get/list/create/patch, plus status/connect for auth), with coherent drive_* and slides_* prefixes for the ancillary integrations. Minor deviations: update is expressed as both classroom_update_course and classroom_patch_* elsewhere, and classroom_copy_post/post_announcement use the vague noun 'post'.

    Tool Count3/5

    26 tools is at the heavy end, inflated by five classroom resources each exposing get/list/create/patch plus three helper tools (status, connect, overview). The grouping is logical and few tools feel redundant, but the surface is larger than a teacher-facing workflow usually needs.

    Completeness2/5

    No delete operations at all for courses, assignments, materials, announcements or topics, so most resources are dead ends once created. The Classroom domain is also only partially covered: no student roster, submissions, grading, or return-work operations, and drive/slides are read-only-plus-upload stubs (slides cannot be created or edited).

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables Claude to manage Google Workspace services such as Calendar, Gmail, and Docs with configurable access and safe-by-design limitations.
      2
      -
    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to interact with Google Classroom to check submission statuses, list students and assignments, and create coursework, announcements, and topics through natural language.
      -