Moodle MCP server

Moodle MCP Server

An MCP server for AI assistants (Claude Code, Cursor, Codex and other stdio clients) on top of the Moodle web services REST API. It is built for teachers: the assistant can see courses, assignments and student submissions, download submission files, and save a grade with feedback, acting as the teacher and only after the teacher confirms. Unlike student-oriented Moodle MCP servers, the focus here is reviewing assignments and grading.

The server works with any Moodle site that has the mobile web service (moodlemobileapp) enabled: the token is issued the same way as for the Moodle mobile app, so login through an external OAuth provider with a captcha works too.

Prerequisites

To check: /admin/tool/mobile/launch.php should open rather than return an error.

• Node.js ≥ 22.
• Google Chrome or Chromium, for the moodle-mcp-login command.
• Mobile app access enabled on the Moodle site (Site administration → Mobile app).

Quick start

The example below uses https://moodle.example.org; replace it with your Moodle address exactly as it appears in the browser (scheme, host, path; a trailing slash does not matter).

(Moodle login and server token, in Russian):

1. Log in, once per machine and again whenever a tool returns a login error

MOODLE_URL=https://moodle.example.org npx -y -p @av-leschinskiy/moodle-mcp moodle-mcp-login

A Chrome window opens: log in to the site as usual and solve the captcha yourself. The command prints Logged in as on and closes the window. Without -p, npx would start the server instead of the login command. Chrome is looked up in PATH; on macOS and Windows, set its path in MOODLE_CHROME.

1. Add the server to your client. Claude Code:

claude mcp add moodle -e MOODLE_URL=https://moodle.example.org -- npx -y @av-leschinskiy/moodle-mcp

Add -s user to enable it for all projects; without it, only for the current one.

Codex, with a command or a block in ~/.codex/config.toml:

codex mcp add moodle --env MOODLE_URL=https://moodle.example.org -- npx -y @av-leschinskiy/moodle-mcp

[mcp_servers.moodle]
   command = "npx"
   args = ["-y", "@av-leschinskiy/moodle-mcp"]
   env = { MOODLE_URL = "https://moodle.example.org" }

Cursor and other clients: a stdio server with the command npx -y @av-leschinskiy/moodle-mcp and the MOODLE_URL variable:

{
     "mcpServers": {
       "moodle": {
         "command": "npx",
         "args": ["-y", "@av-leschinskiy/moodle-mcp"],
         "env": { "MOODLE_URL": "https://moodle.example.org" }
       }
     }
   }

1. Check: ask the assistant "show my Moodle courses".

From a repository clone, use node /dist/index.js and node /dist/cli/login.js instead of npx: dist/ is committed, no build is needed.

What's inside

<!-- BEGIN:tools-table (generated by scripts/tool-docs.mjs) -->

9 tools in total; 3 of them require user confirmation.

Full list of names

Site

• moodlelistcourses
• moodlesiteinfo

Assignments and submissions

• moodlegetsubmission
• moodlelistassignments
• moodlelistsubmissions

Files

• moodledownloadfile

Grading

• moodleaddsubmission_comment — confirmation
• moodlerevertsubmissiontodraft — confirmation
• moodlesavegrade — confirmation

Shortened. The full README is on GitHub.