Moodle Student Bridge
Provides tools for interacting with a Moodle instance as a student, including courses, assignments, quizzes, course materials and files, announcements/forums, notifications, messages, and grades.
Sends optional mobile reminders and notifications through ntfy topics for upcoming Moodle deadlines, grade or feedback updates, and daily summaries.
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., "@Moodle Student Bridge What assignments are due this week?"
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.
Moodle Student Bridge
Conecta a Claude con tu Moodle como estudiante: entregas, cuestionarios, enunciados, rúbricas, archivos, anuncios, notificaciones y calificaciones. Y recordatorios en tu celular.
Está pensado para estudiantes cuya universidad no les da un token de API: usa el mismo token que
la app móvil oficial de Moodle (servicio moodle_mobile_app), que cualquier alumno puede obtener
con su propia cuenta. Funciona con cualquier Moodle que tenga la app móvil habilitada.
Proyecto independiente; no está afiliado a Moodle Pty Ltd. Solo lee: nunca entrega tareas ni modifica nada en tu Moodle.
Herramientas MCP
Herramienta | Qué hace |
| Todo lo pendiente y lo nuevo en una sola llamada |
| Línea de tiempo: lo que vence en los próximos N días (y lo vencido) |
| Cursos en los que estás matriculado |
| Tareas por curso con fechas |
| Enunciado, rúbricas, adjuntos, estado de tu entrega y retroalimentación |
| Cuándo abren/cierran, tiempo límite, intentos usados y mejor nota |
| Secciones, recursos, archivos y enlaces de un curso |
| Extrae el texto de PDF, Word (.docx), PowerPoint (.pptx) y HTML; devuelve imágenes |
| Avisos de profesores y foros |
| La campana: notas publicadas, retroalimentación, cambios (no las marca como leídas) |
| Conversaciones de mensajería |
| Tu libro de calificaciones por curso |
| Comprueba con qué cuenta estás conectado |
Cursos y tareas se pueden indicar por id o por parte del nombre ("fisica", "segundo parcial").
Ejemplos: "¿Qué tengo pendiente esta semana?", "Revisa la tarea del proyecto de Física y hazme un plan según la rúbrica", "Lee el PDF de Leyes de Kepler y resúmelo", "¿Cómo voy en Física?".
Related MCP server: moodle-mcp
1. Obtener tu token
npx moodle-student-bridge-tokenEl asistente te pregunta cómo inicias sesión:
Usuario y contraseña de Moodle → obtiene el token directamente.
Microsoft / Google / SSO → te da un enlace
launch.php. Ábrelo con tu sesión iniciada y las DevTools abiertas (F12 → Network), copia la redirecciónmoodlemobile://token=...y pégala.
Comprueba el token y lo guarda en .env:
MOODLE_URL=https://moodle.tu-universidad.edu
MOODLE_TOKEN=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
MOODLE_TZ=America/Guayaquil # opcional2. Conectarlo a Claude
Claude Desktop (lo más fácil): descarga moodle-student-bridge.mcpb de los Releases, ábrelo con
doble clic y pega tu URL y token en el formulario.
Claude Code:
claude mcp add moodle-student --scope user \
-e MOODLE_URL=https://moodle.tu-universidad.edu -e MOODLE_TOKEN=tu_token \
-- npx -y moodle-student-bridgeDesde el código fuente:
git clone <repo> && cd moodle-student-bridge && npm install
npm run token # crea el .env
npm run probar # prueba: tu usuario y lo que vence esta semana
claude mcp add moodle-student --scope user -- node /ruta/a/moodle-student-bridge/src/index.js3. Recordatorios en el celular (opcional)
Usa ntfy: gratis y sin cuenta.
Instala la app ntfy (Android/iOS) y suscríbete a un tema con un nombre largo y difícil de adivinar (ej.
moodle-ana-8f3k2q9z). Cualquiera que conozca el nombre puede leer los avisos.Elige dónde se ejecuta:
En la nube con GitHub Actions (funciona con la PC apagada): haz un fork de este repo y añade en Settings → Secrets and variables → Actions los secretos
MOODLE_URL,MOODLE_TOKENyNTFY_TOPIC. Luego activa los workflows en la pestaña Actions (en los forks vienen desactivados).recordatorios.ymlcorre cada hora y manda el resumen del día a las 07:00 (hora de Ecuador; cámbialo en elcron). Los secretos van cifrados y los registros solo muestran cuántos avisos se enviaron, nunca su contenido, así que el fork puede ser público.En tu PC: programa
node src/recordar.jscada hora ynode src/recordar.js --resumenuna vez al día (Programador de tareas de Windows ocron).
Prueba sin enviar nada:
npm run recordar -- --prueba.
Qué recibes:
⏰ Un aviso 24 h y otro 3 h antes de cada entrega pendiente (
RECORDAR_HORAS=24,3).📝 Aviso cuando publican una calificación o retroalimentación.
📚 Un resumen diario con lo que vence en la semana.
Ya entregaste algo → deja de avisarte (Moodle ya no lo marca como pendiente).
Privacidad: los avisos (nombre de la tarea y curso) pasan por el servidor de ntfy. Si prefieres,
usa tu propio servidor con NTFY_SERVER y NTFY_TOKEN.
Variables de entorno
Variable | Uso |
| Obligatorias |
| Zona horaria para fechas (por defecto la del sistema) |
| Carpeta para archivos descargados (por defecto |
| Recordatorios |
| Cuándo avisar (por defecto |
Las variables de entorno tienen prioridad sobre el .env.
Seguridad
El token da acceso a tu cuenta casi como tu contraseña. No subas el
.env(está en.gitignorey.mcpbignore) ni lo pegues en chats.Para revocarlo: Moodle → Preferencias → Claves de seguridad → restablecer la del servicio móvil.
leer_archivosolo descarga archivos del Moodle configurado.
Desarrollo
npm test # tests (sin red)
npm run probar -- ver_tarea '{"tarea":"proyecto"}' # llama una herramienta contra tu Moodle
npm run mcpb # genera moodle-student-bridge.mcpb para Claude DesktopLicencia MIT.
Available Tools
14 toolsanunciosA
Anuncios de profesores y discusiones de foros recientes. Por defecto solo los foros de Avisos/Anuncios.
Inputs: dias, curso, incluir_foros_generales.
calificacionesB
Muestra mis calificaciones de un curso (libro de calificaciones).
Inputs: curso (required).
cuestionariosB
Cuestionarios/exámenes en línea: cuándo abren y cierran, tiempo límite, intentos usados y mejor nota.
Inputs: curso, solo_disponibles.
leer_archivoA
Descarga un archivo de Moodle (URL de pluginfile que aparece en ver_tarea, ver_curso o ver_discusion). Extrae el texto de PDF, Word (.docx), PowerPoint (.pptx), páginas HTML y texto; devuelve imágenes; otros formatos se guardan en disco.
Inputs: url (required).
listar_cursosA
Lista los cursos en los que está matriculado el usuario.
Inputs: no named parameters.
listar_tareasB
Lista las tareas (mod_assign) del usuario con sus fechas. Se puede filtrar por curso.
Inputs: curso, solo_futuras.
mensajesC
Conversaciones de la mensajería de Moodle (mensajes de profesores o compañeros) con su último mensaje.
Inputs: limite.
notificacionesB
Notificaciones de la campana de Moodle: calificaciones publicadas, retroalimentación, mensajes de foros, cambios en tareas, etc. No las marca como leídas.
Inputs: limite, solo_no_leidas.
proximos_vencimientosB
Línea de tiempo: actividades con fecha de entrega próxima o vencida (tareas, cuestionarios, foros…). Úsala para recordatorios.
Inputs: dias, incluir_vencidas.
quien_soyA
Muestra el usuario y el sitio Moodle conectados (sirve para comprobar el token).
Inputs: no named parameters.
resumen_semanalA
Resumen de todo lo importante en una sola llamada: entregas próximas y vencidas, cuestionarios abiertos, anuncios recientes de profesores y notificaciones sin leer. Úsala para '¿qué tengo pendiente?' o '¿qué hay de nuevo?'.
Inputs: dias.
ver_cursoB
Muestra el contenido de un curso: secciones, actividades, recursos y archivos.
Inputs: curso (required), seccion.
ver_discusionB
Muestra una discusión de foro completa (anuncio y respuestas) con sus adjuntos.
Inputs: discusion (required).
ver_tareaA
Muestra una tarea completa: enunciado, fechas, archivos adjuntos, estado de mi entrega y retroalimentación.
Inputs: tarea (required), curso.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 14 tools
Most tools target distinct resources, but there's semantic overlap among the deadline-oriented tools: proximos_vencimientos, resumen_semanal, listar_tareas, and cuestionarios all surface upcoming dates, and an agent could hesitate over which to call. Mensajes vs notificaciones also mildly overlap since forum/message alerts appear in both. Descriptions largely clarify the intended use (resumen_semanal for 'what's pending', proximos_vencimientos for reminders), keeping it above average.
There is a partial convention (ver_* for detail views like ver_tarea/ver_curso/ver_discusion, listar_* for listings like listar_cursos/listar_tareas), but several tools are bare nouns (mensajes, anuncios, calificaciones, notificaciones, cuestionarios) and others are phrase-like (quien_soy, proximos_vencimientos, resumen_semanal). It's readable but mixes noun-only and verb_noun styles without a strict pattern.
14 tools sit comfortably in the well-scoped range for a learning-platform bridge, covering messaging, forums, courses, assignments, quizzes, grades, files, and notifications. Each tool maps to a recognizable Moodle feature, and none feels like filler.
The read surface is broad: courses, content, assignments, quizzes, forums, messages, grades, notifications, files, deadlines, and profile all have coverage, plus an aggregate summary. Gaps are mostly intentional read-only limits (no assignment submission, no posting/reply, notifications are not marked read), which agents can note but not work around.
Maintenance
Related MCP Connectors
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.
Your Telegram, WhatsApp, Instagram, mail and calendar in Claude or ChatGPT. Never sends messages.
Study from your own classes: synced Canvas coursework, notes, flashcards and study progress.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides Claude with full access to Moodle learning management systems, enabling interaction with courses, files, assignments, grades, and calendar events. It also supports building Obsidian study vaults from course materials through automated knowledge graph creation.22 npm18MIT
- AlicenseBqualityCmaintenanceConnects Claude to your Moodle account through the same web-service API the mobile app uses. Enables asking about upcoming and overdue deadlines, reading course files and announcements, checking grades, searching course content, and saving assignment submissions from chat.172MIT
- AlicenseAqualityBmaintenanceGives Claude Code read-only access to a student's eNauczanie PG (Moodle) account, enabling retrieval of courses, deadlines, grades, announcements, forum discussions, and quiz reviews using the student's web service token.14MIT
- AlicenseNot gradedqualityCmaintenanceConnects Claude to a student's Moodle account so it can retrieve courses, pending assignments, grades, notices, materials, forums, and submission status, and can publish forum posts or upload assignments after confirmation.MIT