Moodle ITESCAM MCP
Provides tools for interacting with a Moodle student account via the official Moodle Web Services API: listing courses and course contents, retrieving assignments and upcoming deadlines, checking submission status and grades, viewing calendar events and news forum announcements, downloading course resources, and submitting assignment files after explicit user confirmation.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Moodle ITESCAM MCP
Servidor MCP que permite a un asistente de IA (Claude Code, Claude Desktop, Codex u otro cliente MCP) consultar tu cuenta de estudiante en Moodle ITESCAM: cursos, contenidos, tareas, fechas límite, calificaciones, calendario y avisos.
Usa la API oficial de Moodle (Web Services, el mismo servicio de la app móvil). No lee HTML, no guarda tu contraseña. Las consultas son de lectura; la entrega de archivos requiere confirmación explícita en un cliente MCP compatible con elicitation.
Requisitos
Node.js 24 o superior y npm
Una cuenta de estudiante de Moodle ITESCAM
Related MCP server: mcp-moodle
Instalación
git clone https://github.com/Jack-SparrowQ/Mod-MCP.git moodle-itescam-mcp
cd moodle-itescam-mcp
npm install
npm run buildEn PowerShell de Windows, si
npmfalla con "running scripts is disabled", usanpm.cmd.
Obtener tu token
El servidor se autentica con un token de Moodle, nunca con tu contraseña.
npm run tokenTe pide usuario y contraseña (la contraseña no se muestra al escribirla), obtiene el token y lo
guarda en .env como MOODLE_TOKEN. El token no se imprime en pantalla y la contraseña no se
guarda en ningún sitio.
.envestá en.gitignore: nunca lo subas al repositorio.El token aparece en Moodle en Preferencias → Claves de seguridad (servicio
moodle_mobile_app). Desde ahí puedes revocarlo en cualquier momento.Para "cerrar sesión": revoca la clave en Moodle y borra la línea
MOODLE_TOKENde.env.
Variables de .env (plantilla en .env.example):
Variable | Obligatoria | Valor por defecto |
| sí | — (lo escribe |
| no |
|
| no |
|
| no |
|
El servidor carga el .env de la carpeta del proyecto aunque el cliente MCP lo lance desde otra
carpeta.
Conectar un cliente MCP
Usa la ruta absoluta a dist/index.js de tu copia del proyecto.
Claude Code
claude mcp add --transport stdio moodle-itescam -- node /ruta/a/moodle-itescam-mcp/dist/index.jsCodex
codex mcp add moodle-itescam -- node /ruta/a/moodle-itescam-mcp/dist/index.jsClaude Desktop — en claude_desktop_config.json:
{
"mcpServers": {
"moodle-itescam": {
"command": "node",
"args": ["/ruta/a/moodle-itescam-mcp/dist/index.js"]
}
}
}Reinicia el cliente y pídele: "Comprueba mi conexión con Moodle" (usa moodle_auth_status).
Herramientas
Las herramientas actúan únicamente sobre tu cuenta: ninguna acepta un id de usuario.
moodle_submit_assignment es la única que escribe en Moodle y siempre requiere confirmación.
Las fechas se devuelven en ISO 8601 (UTC).
Herramienta | Entradas | Devuelve |
| — | si el token es válido y la versión del sitio |
| — | tu nombre, usuario, correo y URL de perfil |
|
| tus cursos; |
|
| secciones y actividades (archivos: solo metadatos) |
|
| tareas; primero las próximas |
|
| instrucciones, estado de tu entrega, si está vencida y su nota |
|
| lo que aún tienes pendiente, incluidas las vencidas |
|
| eventos del calendario |
|
| resumen por curso, o elementos y total de un curso |
|
| avisos de los foros de noticias |
|
| ruta local y metadatos de un archivo del curso |
|
| entrega verificada, tras confirmación en el cliente |
Las descargas se guardan en downloads/<courseId>/ dentro del proyecto, con un límite de 50 MB
por archivo (configurable con MAX_DOWNLOAD_MB). Los archivos existentes nunca se sobrescriben;
se añade un sufijo al nombre. En carpetas se descarga un archivo por petición.
Entregar una tarea
Coloca los archivos en submissions/ dentro del proyecto (carpeta ignorada por Git), por ejemplo
submissions/practica/informe.pdf. Pasa practica/informe.pdf en files, junto al assignmentId
obtenido con moodle_get_assignments. No se aceptan rutas absolutas ni archivos fuera de esa
carpeta, enlaces simbólicos, archivos vacíos o duplicados.
El cliente mostrará un formulario de confirmación con curso, tarea, archivos y tamaños, fecha
límite y avisos de entrega tardía o reemplazo de borradores. Debes confirmar y, si corresponde,
aceptar la declaración de autoría. La IA no puede responder ese formulario. Sin un cliente con
elicitation de formularios (Claude Code; Codex también la declara), no se sube ni entrega nada.
Codex en modo no interactivo (codex exec) rechaza la confirmación automáticamente y además
bloquea las herramientas que no son de solo lectura, así que nunca puede entregar sin ti. Solo se informa éxito
cuando Moodle devuelve el estado submitted; las escrituras no se reintentan automáticamente. Si
los archivos llegaron a guardarse como borrador pero la entrega no se confirmó, el error lo indica
(draftSaved: true): revisa la tarea en Moodle antes de reintentar.
Ejemplos de peticiones: "¿Qué tareas tengo pendientes esta semana?", "Muéstrame mis calificaciones de Redes", "¿Qué hay en la sección 3 de Sistemas Operativos?".
Errores
Las herramientas devuelven { error: { code, message, suggestion } } con estos códigos:
Código | Qué hacer |
| falta el token o fue revocado: ejecuta |
| no estás inscrito en ese curso o no existe esa tarea |
| Moodle no te permite ver eso |
| Moodle no responde; inténtalo más tarde |
| parámetros inválidos (p. ej. |
| el servicio web de Moodle no está disponible |
| Moodle devolvió algo inesperado |
Privacidad y seguridad
La IA nunca ve tu contraseña ni el token. Sí ve los datos académicos que le pidas (nombre, correo, notas…), porque ese es el propósito de la herramienta.
Los logs van a stderr y solo registran la función de Moodle llamada, la duración y el resultado: sin parámetros, datos personales ni token.
Solo se pueden llamar 12 funciones de lectura de Moodle (lista explícita en
src/infrastructure/moodle/rest-client.ts). Las dos funciones de entrega tienen una vía de escritura separada, usada únicamente después de la confirmación. No hay funciones de profesor.No se devuelven enlaces de descarga de archivos.
Efecto de Moodle al consultar el estado de una tarea: la primera vez que se consulta una tarea abierta (
moodle_get_assignment, o las comprobaciones previas demoodle_submit_assignment), Moodle crea un registro de entrega vacío con estadonew, igual que al abrir la tarea en el navegador. No contiene archivos, no es una entrega y no afecta a la calificación.
Limitaciones actuales
Entregas: solo archivos, sin texto en línea, reenvíos ni entregas de grupo. Requiere un cliente con elicitation de formularios; una tarea ya entregada se rechaza.
Avisos: solo la primera página de cada foro de noticias.
Fechas límite y calendario: como máximo 200 elementos por consulta (
truncated: truesi hay más).Probado contra Moodle ITESCAM 4.1.1+. Otras instalaciones de Moodle pueden funcionar si tienen habilitado el servicio móvil, pero no están verificadas.
Desarrollo
npm run typecheck # tsc --noEmit
npm test # Vitest; la red real está bloqueada en los tests
npm run dev # servidor con tsx (sin compilar)Arquitectura: docs/architecture.md. Requisitos: docs/requirements.md. Hallazgos sobre Moodle
ITESCAM: docs/moodle-investigation.md. Decisiones: docs/decisions/.
Licencia
ISC — ver LICENSE.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
PLATO (Pusan National University LMS) MCP server via Moodle Web Service API + ubboard scraping
Read your plat.plus courses, tasks, course pages, sessions, files and messages. Read-only.
iSpring Learn (iSpring LMS) MCP server for ChatGPT, Claude and any AI agent: enroll users in courses, list enrollments, get learner progress report, cancel enrollment, reset enrollment progress, add users by email, deactivate users and list courses in your own iSpring Learn (iSpring LMS) account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to iSpring Learn (iSpring LMS) yourself; Cotlet does not store your password and you need no iSpring Learn (iSpring LMS) API key. About the official iSpring Learn (iSpring LMS) API: iSpring Learn has a REST API, but only with the Business subscription, and no official MCP server (checked 20 Oct 2026). The API covers users, departments, courses, enrollments and results, so an agent needs custom code and a token; the Zapier app covers users, departments and enrollments but has no progress or report actions. Setup and FAQ: https://cotlet.dev/integrations/ispring-api-mcp-server
Run the Geduk LMS from an AI assistant: courses, sessions, enrolments, users and catalogue.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables interaction with Moodle learning management systems through the Moodle REST API. Supports course management, user enrollment, assignments, forums, quizzes, and file operations through natural language.MIT
- AlicenseAqualityCmaintenanceEnables AI assistants to interact with Moodle via web services, allowing tasks like listing courses, assignments, events, and downloading files.104MIT
- AlicenseAqualityCmaintenanceEnables querying courses, assignments, deadlines, and materials from the UNAM Moodle virtual classroom, as well as downloading files and submitting assignments through natural language.8MIT
- AlicenseNot gradedqualityBmaintenanceEnables an AI agent to access a Moodle Campus Virtual account with the user's own credentials, reading course content, files, forums, notices, calendar, grades and quiz attempts for every enrolled course. Teachers, managers and course creators also get access to other participants' data and to planned, verified write operations such as forums, grading, attendance, quizzes, groups, content and H5P activities.4Apache 2.0