Moodle MCP Server
Provides tools for interacting with Moodle's REST API, enabling listing courses, retrieving users and enrolled users, fetching grades, SCORM modules, and completion reports.
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 MCP Server show enrolled users in course 3"
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 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 .envRenseigne ensuite .env :
Variable | Obligatoire | Description |
| Oui | URL du endpoint REST Moodle, ex: |
| Oui | Token du web service Moodle |
| Non (mode HTTP uniquement) | Port d'écoute du serveur HTTP (défaut |
| Oui (mode HTTP uniquement) | Token d'accès au serveur HTTP — génère-le avec |
Mode stdio (Claude Code / Claude Desktop)
npm run dev # développement (tsx)
npm run build && npm run start # productionDans 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 # productionLe 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_TOKENcomme un secret critique, au même titre queMOODLE_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 |
| Liste les cours disponibles sur Moodle |
| Récupère une liste d'utilisateurs Moodle |
| Liste les utilisateurs inscrits dans un cours |
| Récupère les notes d'un utilisateur dans un cours |
| Liste les modules SCORM disponibles dans un ou plusieurs cours |
| Génère un rapport de complétion pour un module SCORM |
| 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, handlerstools/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 toolsmoodle_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
Scored across 7 tools
Each tool targets a distinct entity or action: courses, users, enrolled users, grades, SCORM modules, SCORM completion, and course completion. No significant overlap.
All tool names follow a consistent 'moodle_get_<object>' pattern using snake_case, making them predictable and easy to understand.
Seven tools provide a focused set of operations for a Moodle integration, covering core reporting needs without excessive or insufficient granularity.
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
Related MCP Connectors
Run the Geduk LMS from an AI assistant: courses, sessions, enrolments, users and catalogue.
Marketo MCP server for AI. 130 tools to operate Marketo from Claude, Cursor, or ChatGPT.
Absorb LMS MCP server for ChatGPT, Claude and any AI agent: list users, list course enrollments, list overdue learners, approve enrollment request, enroll users in a course, message learners, create user and deactivate user in your own Absorb LMS account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Absorb LMS yourself; Cotlet does not store your password and you need no Absorb LMS API key. About the official Absorb LMS API: Absorb LMS has an Integration API, a REST API with JSON for learners, courses, departments and grades, but it needs a private key tied to your portal that your Absorb account team provides, and your own code (checked 20 Oct 2026). Absorb's Aura MCP for Claude and ChatGPT is planned for 27 Oct 2026 and is read and answer only. Setup and FAQ: https://cotlet.dev/integrations/absorb-lms-api-mcp-server
LearnWorlds MCP server for ChatGPT, Claude and any AI agent: list users, list course learners, enroll users, unenroll users, update tags, send message, suspend user and grade assessment in your own LearnWorlds account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to LearnWorlds yourself; Cotlet does not store your password and you need no LearnWorlds API key. About the official LearnWorlds API: LearnWorlds has a REST API (v2) for courses, users, bundles, subscriptions, promotions, payments and certifications, but it comes with the Learning Center plan and higher, and you need your own code to use it (checked 5 Nov 2026). LearnWorlds has no official MCP server. Setup and FAQ: https://cotlet.dev/integrations/learnworlds-api-mcp-server
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
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to interact with Moodle LMS via the Moodle REST API, supporting management of courses, users, enrollments, grades, and content.1GPL 3.0
- AlicenseNot gradedqualityAmaintenanceEnables 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.29MIT
- AlicenseNot gradedqualityBmaintenanceConnects 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.7MIT