Moodle MCP Server

What is 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.

How to use Moodle MCP Server?

Clone the repo, install dependencies, create a .env file with your Moodle API URL, token, and course ID, then build the server. Configure it as an MCP server in Claude Desktop by editing claude_desktop_config.json with the path to Node and the built index.js.

Key features of Moodle MCP Server

• list_students – retrieve enrolled students with ID, name, email, last access
• get_assignments – list all assignments with due dates and max grades
• get_student_submissions – view a student’s submissions for an assignment
• provide_assignment_feedback – add grades and comments to a submission
• get_quizzes – list all quizzes with opening/closing dates and max grades
• get_quiz_attempts – view a student’s attempts on a quiz
• provide_quiz_feedback – add comments to a specific quiz attempt

Use cases of Moodle MCP Server

• Automate viewing student lists and their submission statuses.
• Provide grades and comments for assignments directly via an LLM.
• Examine student quiz attempts and offer feedback without manual Moodle navigation.
• Let an AI assistant help instructors manage course work through natural language.

FAQ from Moodle MCP Server

What are the requirements to run Moodle MCP Server?

Node.js v14 or higher, a valid Moodle API token with appropriate permissions, and a Moodle course ID.

How do I obtain a Moodle API token?

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

Where is the server configuration stored for Claude Desktop?

On macOS at ~/Library/Application Support/Claude/claude_desktop_config.json; on Windows at %APPDATA%/Claude/claude_desktop_config.json.

How does the server communicate with clients?

MCP servers communicate through stdio. The README recommends using the MCP Inspector for debugging.

Is it safe to share my .env file or API token?

No. Never share your .env file or Moodle API token. Use a token with the minimum necessary permissions and ensure the server only accesses the courses it needs.