Skip to main content
Glama
Moodle MCP Server

Moodle MCP Server

Moodle MCP Server

Serveur MCP (Model Context Protocol) qui expose des données Moodle (cours, utilisateurs, inscriptions, notes, SCORM, rapports de complétion) sous forme d'outils utilisables par Claude.

Deux modes de transport sont disponibles :

  • stdio — pour un usage local avec Claude Code ou Claude Desktop.

  • HTTP (Streamable HTTP) — pour déployer le serveur et l'ajouter comme connecteur personnalisé distant sur claude.ai.

Prérequis

  • Node.js 20+

  • Une instance Moodle avec le service web REST activé et un token utilisateur (MOODLE_TOKEN)

Related MCP server: Moodle MCP Server

Installation

npm install
cp .env.example .env

Renseigne ensuite .env :

Variable

Obligatoire

Description

MOODLE_URL

Oui

URL du endpoint REST Moodle, ex: https://moodle.tonsite.fr/webservice/rest/server.php

MOODLE_TOKEN

Oui

Token du web service Moodle

PORT

Non (mode HTTP uniquement)

Port d'écoute du serveur HTTP (défaut 3000)

MCP_ACCESS_TOKEN

Oui (mode HTTP uniquement)

Token d'accès au serveur HTTP — génère-le avec openssl rand -hex 32

Mode stdio (Claude Code / Claude Desktop)

npm run dev      # développement (tsx)
npm run build && npm run start   # production

Dans la config MCP de Claude Code/Desktop, pointe simplement vers node dist/index.js (après npm run build) avec les variables d'environnement MOODLE_URL/MOODLE_TOKEN chargées via .env.

Mode HTTP (connecteur distant claude.ai)

npm run dev:http      # développement (tsx)
npm run build && npm run start:http   # production

Le serveur écoute sur POST /mcp (port PORT, défaut 3000). Chaque requête doit inclure le token d'accès en paramètre de requête :

https://ton-domaine.com/mcp?token=<MCP_ACCESS_TOKEN>

C'est cette URL qu'il faut renseigner dans le champ URL du serveur MCP distant du formulaire "Ajouter un connecteur personnalisé" de claude.ai.

Sans MCP_ACCESS_TOKEN défini, le serveur refuse de démarrer (aucun mode non protégé possible). Une requête sans token, ou avec un token invalide, reçoit une réponse 401. GET/DELETE /mcp renvoient 405 (pas de sessions, le transport est sans état).

⚠️ Sécurité : token dans l'URL

Le formulaire de connecteur claude.ai ne permet pas d'envoyer un en-tête HTTP personnalisé, seulement une URL — le token est donc transmis en paramètre de requête plutôt qu'en en-tête Authorization. Tout proxy inverse, CDN, load balancer ou autre infrastructure placée devant ce serveur et qui journalise les URLs complètes des requêtes capturera ce token dans ses logs. Avant un déploiement public :

  • désactive la journalisation des query strings sur tes proxies, ou redacte-les ;

  • traite MCP_ACCESS_TOKEN comme un secret critique, au même titre que MOODLE_TOKEN.

Le déploiement effectif (Docker, systemd, reverse proxy, certificat TLS) n'est pas couvert par ce dépôt — c'est une étape à part, propre à ton infrastructure.

Outils MCP disponibles

Outil

Description

moodle_get_courses

Liste les cours disponibles sur Moodle

moodle_get_users

Récupère une liste d'utilisateurs Moodle

moodle_get_enrolled_users

Liste les utilisateurs inscrits dans un cours

moodle_get_grade_items

Récupère les notes d'un utilisateur dans un cours

moodle_get_scorms_by_courses

Liste les modules SCORM disponibles dans un ou plusieurs cours

moodle_get_scorm_completion_report

Génère un rapport de complétion pour un module SCORM

moodle_get_completion_report

Génère un rapport de complétion pour un cours

Architecture

  • src/moodleClient.ts — client HTTP vers l'API REST Moodle (avec cache).

  • src/tools/*.ts — définition des outils MCP (schéma Zod + handler).

  • src/server.ts — construction du serveur MCP (liste des outils, handlers tools/list/tools/call), partagée par les deux transports.

  • src/index.ts — point d'entrée stdio.

  • src/httpServer.ts — point d'entrée HTTP (Express, transport sans état, authentification par token).

Available Tools

7 tools
moodle_get_completion_reportC

Génère un rapport de complétion pour un cours.

Inputs: courseid (required).

moodle_get_coursesC

Liste les cours disponibles sur Moodle.

Inputs: options.

moodle_get_enrolled_usersB

Liste les utilisateurs inscrits dans un cours.

Inputs: courseid (required).

moodle_get_grade_itemsB

Récupère les notes d'un utilisateur dans un cours.

Inputs: userid (required), courseid (required).

moodle_get_scorm_completion_reportC

Génère un rapport de complétion pour un module SCORM.

Inputs: scormid (required), courseid.

moodle_get_scorms_by_coursesB

Liste les modules SCORM disponibles dans un ou plusieurs cours.

Inputs: courseids (required).

moodle_get_usersC

Récupère une liste d'utilisateurs Moodle.

Inputs: criteria.

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 7 tools

    Disambiguation5/5

    Each tool targets a distinct entity or action: courses, users, enrolled users, grades, SCORM modules, SCORM completion, and course completion. No significant overlap.

    Naming Consistency5/5

    All tool names follow a consistent 'moodle_get_<object>' pattern using snake_case, making them predictable and easy to understand.

    Tool Count5/5

    Seven tools provide a focused set of operations for a Moodle integration, covering core reporting needs without excessive or insufficient granularity.

    Completeness3/5

    The tools are limited to retrieval operations, missing create/update/delete functionality. Key areas like assignments, forums, or quizzes are absent, indicating notable gaps for a full Moodle integration.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides 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 npm
      18
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI agents to sign into a real Moodle LMS and handle the student workflow end to end: browsing courses, schedules, forums and grades, converting assignments and attachments into markdown, and uploading and submitting work as drafts or finalized submissions. Ships as a single static binary with write actions confirmed by the user and quiz-taking deliberately excluded.
      29
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Connects a student's own Moodle account to Claude Code, Codex, ChatGPT and other AI clients, exposing courses, deadlines, assignments, quizzes, grades, attendance, materials, forums and groups through 55 tools. Supports reading materials and submitting assignments, with per-user tokens and write actions kept as separate, confirmable tools.
      7
      MIT