Moodle MCP Server
The Moodle MCP Server enables LLMs to interact with the Moodle platform to effectively manage courses, students, assignments, and quizzes.
Capabilities:
Student Management: Retrieve enrolled students' information (IDs, names, emails, last access times)
Assignment Management: Retrieve course assignments, view student submissions, provide grades and comments
Quiz Management: Retrieve course quizzes, examine student attempts, provide feedback
Detailed Content Access: View specific submission contents including text and attached files
Assessment: Retrieve and manage student grades for quizzes and assignments
Enables interaction with the Moodle platform to manage courses, students, assignments, and quizzes, including viewing student lists, providing feedback on assignments, examining quiz attempts, and grading submissions.
Required runtime environment (v14 or higher) for executing the MCP server that connects to 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 all 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
Course Management Tools
get_courses- Retrieves information about courses in MoodleSupports pagination (
page,limit) to safely fetch all available courses.Optionally allows fetching a specific course by providing a
courseId.
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
The tools are mostly distinct with clear purposes: get_assignments, get_quizzes, get_students, get_submissions, and get_submission_content target different resources, while get_quiz_grade and provide_feedback focus on specific actions. However, get_submissions and get_submission_content could be slightly confusing as they both relate to submissions, though their descriptions clarify the difference between listing submissions and getting detailed content.
All tool names follow a consistent verb_noun pattern using snake_case, starting with 'get_' for retrieval operations and 'provide_' for the feedback action. This uniformity makes the tool set predictable and easy to understand, with no deviations in naming conventions.
With 7 tools, the count is reasonable for a Moodle server focused on course management. It covers key areas like assignments, quizzes, students, and submissions, though it might be slightly thin for broader educational workflows, such as missing tools for creating or updating resources.
The tool set provides good read-only coverage for retrieving course data (assignments, quizzes, students, submissions) and includes a feedback action. However, there are notable gaps in CRUD operations: no tools for creating, updating, or deleting resources (e.g., assignments or quizzes), which limits agent functionality for full lifecycle management in the Moodle domain.
Maintenance
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 the Moodle platform to manage courses, students, assignments, and quizzes.7MIT
- AlicenseNot gradedqualityDmaintenanceA Moodle MCP server so students can collaborate with their courses through the LLM tools.1MIT
- AlicenseAqualityDmaintenanceMCP server that connects AI assistants to Instructure Canvas LMS, enabling teachers and administrators to manage courses, assignments, grades, and more through natural language.8030 npm1MIT
- 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