moodle-mcp

Dale a Claude acceso total a tu Moodle: cursos, archivos, tareas, calificaciones, cuestionarios, calendario y más. Crea bóvedas de estudio en Obsidian a partir de tus apuntes de clase con un solo comando.

13 herramientas · 5 prompts · Recursos MCP

Inicio rápido

1. Instalar

npx moodle-mcp

O instálalo globalmente:

npm install -g moodle-mcp

2. Obtén tu token → ver más abajo

3. Añádelo a tu cliente MCP

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json en Mac, %APPDATA%\Claude\claude_desktop_config.json en Windows):

{
  "mcpServers": {
    "moodle": {
      "command": "npx",
      "args": ["moodle-mcp"],
      "env": {
        "MOODLE_URL": "https://moodle.yourschool.edu",
        "MOODLE_TOKEN": "your_token_here"
      }
    }
  }
}

VS Code (añadir a .vscode/mcp.json):

{
  "servers": {
    "moodle": {
      "command": "npx",
      "args": ["moodle-mcp"],
      "env": {
        "MOODLE_URL": "https://moodle.yourschool.edu",
        "MOODLE_TOKEN": "your_token_here"
      }
    }
  }
}

Obtención de tu token

Opción A — Página de perfil de Moodle (funciona en todas partes)

1. Inicia sesión en el Moodle de tu escuela en un navegador

2. Ve a Perfil → Claves de seguridad (URL: https://moodle.yourschool.edu/user/managetoken.php)

3. Busca el token de Servicio web móvil de Moodle y cópialo

4. Configura MOODLE_TOKEN=<token> en tu configuración de MCP

Opción B — Nombre de usuario + contraseña (escuelas sin SSO)

Si tu escuela utiliza un nombre de usuario/contraseña normal (no Microsoft/Google/SSO), puedes saltarte el paso del token por completo:

"env": {
  "MOODLE_URL": "https://moodle.yourschool.edu",
  "MOODLE_USERNAME": "your_username",
  "MOODLE_PASSWORD": "your_password"
}

⚠️ Escuelas con SSO: Si la página de inicio de sesión de tu escuela redirige a Microsoft, Google u otro proveedor de identidad, la Opción B no funcionará. Usa la Opción A o C.

Opción C — Extraer desde la aplicación móvil de Moodle (escuelas con SSO)

1. Instala la aplicación Moodle en tu teléfono e inicia sesión con SSO

2. Ve a Ajustes de la aplicación → Acerca de

3. Toca el número de versión 5 veces para activar el modo desarrollador

4. Ve a Opciones de desarrollador → Copiar token y cópialo

5. Usa ese token como MOODLE_TOKEN en la Opción A

Herramientas

Prompts

Úsalos en cualquier cliente MCP que admita prompts (Claude Desktop, VS Code con Copilot, etc.):

Preparación de exámenes en Obsidian

Convierte todo tu semestre en un grafo de conocimiento vinculado con un solo comando.

Configuración

1. Instala Obsidian (gratuito, funciona en Mac/Windows/Linux)

2. Crea una nueva bóveda, p. ej. ~/obsidian/finals

3. Asegúrate de que moodle-mcp esté conectado a tu cliente MCP

Construir la bóveda

Usa el prompt /build-study-notes en Claude Desktop:

/build-study-notes courseId=42 vaultPath=~/obsidian/finals

O pega esto directamente en Claude:

Pull my [Course Name] (course ID 42), read all the lecture notes and slides,
and build a linked Obsidian vault at ~/obsidian/finals — one note per topic,
with [[wikilinks]] between related concepts, a MOC.md index, and tags for each section.

Claude hará lo siguiente:

1. Extraerá todas las secciones, archivos, tareas y calificaciones de tu curso

2. Leerá cada PDF y documento directamente a través del protocolo de recursos MCP

3. Escribirá un archivo .md por sección con conceptos clave, definiciones y ejemplos

4. Añadirá [[wikilinks]] entre términos relacionados en todas las notas

5. Creará un índice MOC.md (Mapa de Contenido) que vincule todo

Ver el grafo

1. Abre la bóveda en Obsidian

2. Haz clic en Vista de grafo (icono de la barra lateral o Cmd+G)

3. Todo tu curso aparecerá como un grafo de conocimiento: los conceptos vinculados se agrupan y los temas aislados destacan como cosas a repasar

Búsqueda en lenguaje natural

Una vez construida la bóveda, puedes pedirle a Claude que encuentre contenido específico:

/search-notes courseId=42 query="the central limit theorem and when to use it"

Claude buscará en todos los materiales de tu curso, encontrará los archivos relevantes, los leerá y sintetizará una respuesta directa.

Compatibilidad

Algunas herramientas requieren que el administrador de Moodle habilite servicios web específicos. Ejecuta moodle_get_site_info para ver qué herramientas están disponibles en el Moodle de tu escuela.

Si una herramienta no está disponible, devolverá un mensaje útil explicando lo que tu administrador necesita habilitar; no bloqueará el servidor.

Contribuciones

Las incidencias y PRs son bienvenidas. Abre una incidencia primero para cambios grandes.

Licencia MIT — © 2026 Alexandre Ribeiro