Moodle MCP Server
Enables interaction with the Moodle platform to manage courses, students, assignments, and quizzes. Provides tools for retrieving student lists, managing assignments with feedback, and handling quiz attempts and feedback.
Runs as a Node.js application, requiring v14 or higher for proper functionality when interacting with Moodle's API.
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 list the students in my course"
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
An MCP (Model Context Protocol) server that enables LLMs to interact with the Moodle platform to manage courses, students, assignments, and quizzes.
Features
Student Management Tools
list_students- Retrieves the list of students enrolled in the courseDisplays ID, name, email, and last access time for each student
Assignment Management Tools
get_assignments- Retrieves all available assignments in the courseIncludes information such as ID, name, description, due date, and maximum grade
get_student_submissions- Examines a student's submissions for a specific assignmentRequires the assignment ID and optionally the student ID
provide_assignment_feedback- Provides grades and comments for a student's submissionRequires student ID, assignment ID, grade, and feedback comment
Quiz Management Tools
get_quizzes- Retrieves all available quizzes in the courseIncludes information such as ID, name, description, opening/closing dates, and maximum grade
get_quiz_attempts- Examines a student's attempts on a specific quizRequires the quiz ID and optionally the student ID
provide_quiz_feedback- Provides comments for a quiz attemptRequires the attempt ID and feedback comment
Related MCP server: Moodle MCP
Requirements
Node.js (v14 or higher)
Moodle API token with appropriate permissions
Moodle course ID
Installation
Clone this repository:
git clone https://github.com/your-username/moodle-mcp-server.git
cd moodle-mcp-serverInstall dependencies:
npm installCreate a
.envfile with the following configuration:
MOODLE_API_URL=https://your-moodle.com/webservice/rest/server.php
MOODLE_API_TOKEN=your_api_token
MOODLE_COURSE_ID=1 # Replace with your course IDBuild the server:
npm run buildUsage with Claude
To use with Claude Desktop, add the server configuration:
On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"moodle-mcp-server": {
"command": "/path/to/node",
"args": [
"/path/to/moodle-mcp-server/build/index.js"
],
"env": {
"MOODLE_API_URL": "https://your-moodle.com/webservice/rest/server.php",
"MOODLE_API_TOKEN": "your_moodle_api_token",
"MOODLE_COURSE_ID": "your_course_id"
},
"disabled": false,
"autoApprove": []
}
}
}For Windows users, the paths would use backslashes:
{
"mcpServers": {
"moodle-mcp-server": {
"command": "C:\\path\\to\\node.exe",
"args": [
"C:\\path\\to\\moodle-mcp-server\\build\\index.js"
],
"env": {
"MOODLE_API_URL": "https://your-moodle.com/webservice/rest/server.php",
"MOODLE_API_TOKEN": "your_moodle_api_token",
"MOODLE_COURSE_ID": "your_course_id"
},
"disabled": false,
"autoApprove": []
}
}
}Once configured, Claude will be able to interact with your Moodle course to:
View the list of students and their submissions
Provide comments and grades for assignments
Examine quiz attempts and offer feedback
Development
For development with auto-rebuild:
npm run watchDebugging
MCP servers communicate through stdio, which can make debugging challenging. We recommend using the MCP Inspector:
npm run inspectorThe Inspector will provide a URL to access debugging tools in your browser.
Obtaining a Moodle API Token
Log in to your Moodle site as an administrator
Go to Site Administration > Plugins > Web Services > Manage tokens
Create a new token with the necessary permissions to manage courses
Copy the generated token and add it to your
.envfile
Security
Never share your
.envfile or Moodle API tokenEnsure the MCP server only has access to the courses it needs to manage
Use a token with the minimum necessary permissions
License
Available Tools
7 toolsget_assignmentsB
Obtiene la lista de tareas asignadas en el curso configurado
Inputs: no named parameters.
get_quiz_gradeB
Obtiene la calificación de un estudiante en un quiz específico
Inputs: studentId (required), quizId (required).
get_quizzesB
Obtiene la lista de quizzes en el curso configurado
Inputs: no named parameters.
get_studentsB
Obtiene la lista de estudiantes inscritos en el curso configurado
Inputs: no named parameters.
get_submission_contentC
Obtiene el contenido detallado de una entrega específica, incluyendo texto y archivos adjuntos
Inputs: studentId (required), assignmentId (required).
get_submissionsC
Obtiene las entregas de tareas en el curso configurado
Inputs: studentId, assignmentId.
provide_feedbackC
Proporciona feedback sobre una tarea entregada por un estudiante
Inputs: studentId (required), assignmentId (required), feedback (required), grade.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Most tools have distinct purposes targeting different Moodle resources like assignments, quizzes, students, and submissions, but get_submissions and get_submission_content could be slightly confusing as the latter seems like a more detailed version of the former. The descriptions clarify the difference, but some overlap exists.
All tool names follow a consistent verb_noun pattern using snake_case, starting with 'get_' for retrieval operations and 'provide_' for feedback. This uniformity makes the set predictable and easy to navigate for an agent.
With 7 tools, the count is reasonable for a Moodle server focused on course management tasks. It covers core operations like retrieving assignments, quizzes, students, and submissions, though it might be slightly thin if more advanced features like creating or updating resources are expected.
The server provides good read-only coverage for viewing course elements and feedback, but lacks create, update, or delete operations for resources like assignments or quizzes. This creates notable gaps in CRUD functionality, which could limit agent workflows in a full course management context.
Related MCP Connectors
MCP server for AI dialogue using various LLM models via AceDataCloud
An MCP server that provides an API to LLMs to manage their JumpCloud resources.
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
Related MCP Servers
- AlicenseBqualityDmaintenanceAn MCP server that enables LLMs to interact with Moodle platforms to manage courses, students, assignments, and quizzes through natural language commands.745MIT
- AlicenseNot gradedqualityDmaintenanceA Moodle MCP server so students can collaborate with their courses through the LLM tools.1MIT
- AlicenseNot gradedqualityDmaintenanceA powerful Model Context Protocol (MCP) server that seamlessly integrates AI assistants with Moodle Learning Management System. Enable your AI assistant to access courses, retrieve educational content, download resources, and search through your learning materials.1MIT
- AlicenseAqualityDmaintenanceMCP server for Moodle that lets AI agents publish and manage pedagogical content — courses, lessons, quizzes, forums — via Moodle Web Services with idempotency.45MIT