Moodle MCP Server

What is Moodle MCP Server?

The Moodle MCP Server is an MCP (Model Context Protocol) server that enables LLMs (such as Claude) to interact with the Moodle learning platform. It provides tools for managing courses, students, assignments, and quizzes. It is intended for administrators or educators who want to use AI assistants to perform Moodle tasks.

How to use Moodle MCP Server?

Install by cloning the repository, running npm install, creating a .env file with MOODLE_API_URL, MOODLE_API_TOKEN, and MOODLE_COURSE_ID, then building with npm run build. Configure Claude Desktop by adding the server configuration (with paths to Node.js and the built index.js) to the claude_desktop_config.json file. Once configured, Claude can invoke tools such as get_courses, get_assignments, list_students, get_student_submissions, provide_assignment_feedback, get_quizzes, get_quiz_attempts, and provide_quiz_feedback.

Key features of Moodle MCP Server

• Course management with pagination and optional filtering by course ID
• Student management: list enrolled students with ID, name, email, last access
• Assignment management: view assignments, submissions, and provide graded feedback
• Quiz management: list quizzes, view student attempts, and offer comments
• All tools operate via the Moodle Web Services REST API
• Configurable for any Moodle site using an API token

Use cases of Moodle MCP Server

• An AI assistant can retrieve a course’s student list and their recent activity.
• Query all upcoming assignments and their due dates for a given course.
• Grade a student’s assignment submission by providing a score and written feedback.
• Review a student’s quiz attempts and add comments to guide improvement.

FAQ from Moodle MCP Server

What are the requirements to run this server?

Node.js v14 or higher and a Moodle API token with appropriate permissions for the target course.

How do I obtain a Moodle API token?

Log in as administrator, go to Site Administration > Plugins > Web Services > Manage tokens, create a token with necessary permissions, and copy it into your .env file.

How do I configure the server with Claude Desktop?

Add a JSON entry under mcpServers in the Claude Desktop config file (located at ~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %APPDATA%/Claude/claude_desktop_config.json on Windows) specifying the command and arguments for Node.js and the built server, along with the required environment variables.

How does the server communicate with the LLM?

The server communicates over standard I/O (stdio) using the Model Context Protocol, which is the default transport for MCP servers.

How can I keep the Moodle API token secure?

Never share your .env file or token, ensure the server only accesses the courses it needs, and use a token with the minimum necessary permissions.