google-classroom-mcp
A Google Classroom MCP server that lets teachers manage Classroom content and Drive/Slides resources conversationally through Claude.
Check Classroom connection status and reconnect/sign in without a terminal.
List, search, inspect, and update courses; get an overview of drafts, scheduled posts, and upcoming due work.
Create, list, inspect, and update topics/units.
Create, list, inspect, and patch assignments, short-answer questions, and one-question multiple-choice questions with due dates, points, topics, attachments, drafts, and scheduled publication.
Copy assignments or materials to other courses as drafts, matching topics by name.
Create, list, inspect, and update study materials and announcements, including scheduled posts.
Search Google Drive; upload files from allowed local folders or base64; optionally convert to Google formats.
Read Google Slides presentations by ID.
Safety limits: defaults to drafts, cannot delete, does not grade or view student submissions, and only edits items created through the app.
Allows managing Google Classroom courses, topics, assignments, materials, and announcements, including creating, listing, updating, and scheduling posts. Supports attachments from Drive, links, YouTube, and Forms, with draft mode by default.
Allows uploading files to Google Drive (up to 5 MB) and attaching Drive files to Classroom assignments/materials with configurable share modes (VIEW, EDIT, STUDENT_COPY). Also provides read access to Drive files for attachment by name.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@google-classroom-mcp Create a draft assignment called Practice 05 in ESO 2º Technology, due Friday."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Prepara tu Google Classroom hablando con Claude, como si se lo pidieras a un compañero.
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 setupMá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 | 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é |
| Carpeta de la llave y la sesión. Por defecto, |
| Rutas exactas de la llave y de la sesión. |
| Carpetas desde las que se permite subir archivos, separadas por |
Las 26 herramientas
Área | Herramientas |
Conexión |
|
Cursos |
|
Temas |
|
Tareas y preguntas |
|
Materiales |
|
Anuncios |
|
Drive y Slides |
|
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.mcpbAl 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 toolsclassroom_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_assignmentARead-only
Get full details of a specific assignment by ID.
Inputs: id (required), courseId (required).
classroom_get_courseARead-only
Get full details of a specific course by ID.
Inputs: courseId (required).
classroom_get_materialARead-only
Get full details of a specific course material by ID.
Inputs: id (required), courseId (required).
classroom_get_overviewARead-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_topicBRead-only
Get details of a specific topic by ID.
Inputs: id (required), courseId (required).
classroom_list_announcementsARead-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_assignmentsARead-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_coursesARead-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_materialsARead-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_topicsARead-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_coursesARead-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_statusARead-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_filesARead-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_presentationARead-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
Scored across 26 tools
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.
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'.
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.
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
Related MCP Connectors
Multiple Google accounts (Gmail, Calendar, Drive, Contacts, Tasks) in one Claude connector.
Multiple Google accounts (Gmail, Calendar, Drive, Contacts, Tasks) in one Claude connector.
Connect Claude to your Platform7n workspaces: chat, links, work and decks. One-click OAuth.
Connect Claude to your Platform7n workspaces: chat, links, work and decks. One-click OAuth.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables Claude to manage Google Workspace services such as Calendar, Gmail, and Docs with configurable access and safe-by-design limitations.2-
- FlicenseAqualityCmaintenanceEnables Claude to read and write Google Classroom data, including courses, coursework, materials, announcements, rosters, submissions, and Drive attachment contents.15-
- FlicenseNot gradedqualityCmaintenanceEnables AI assistants to interact with Google Classroom to check submission statuses, list students and assignments, and create coursework, announcements, and topics through natural language.-
- FlicenseNot gradedqualityNot gradedmaintenanceEnables AI assistants to operate Google Classroom, letting users list courses and students, check assignment submissions, and create coursework and announcements through natural language.-