Skip to content
MCP server

Moodle MCP

Moodle LMS for LLM agents: courses, assignments, files, forums and submissions

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, Linux, macOS
Runs
Locally
Version
0.2.1
Listing updated
today

Similar MCP servers

About Moodle MCP

Moodle MCP is an open-source MCP server for education and exams. It runs locally on your machine and is started by your AI client.

The tool signs an agent in as the student and exposes 20 typed tools, plus 2 optional ones, covering the study journey from listing courses to submitting work. Tools take and return local file paths rather than base64, results embed the IDs needed for the next call, and errors suggest a fix. PDFs are converted to markdown, and write tools confirm with the user before acting; submissions stay drafts until the user finalizes. Quiz-taking is intentionally not provided.

A typical request such as finishing a homework chains get_assignment, fetch_file, upload_file and submit_assignment. Others pull deadlines with get_schedule, build a study plan, or catch up on forums. The opt-in call_ws_function reaches about 350 other Moodle web-service functions.

It is a single Rust binary built on the rmcp SDK, verified live on Moodle 3.7, 4.5 and 5.2, and needs a site that allows the mobile web service and a token from moodle-mcp auth. MIT licensed.

Install

Run in a terminal

claude mcp add moodle-mcp --env MOODLE_URL='<MOODLE_URL>' --env MOODLE_TOKEN='<MOODLE_TOKEN>' -- npx -y moodle-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "moodle-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "moodle-mcp"
      ],
      "env": {
        "MOODLE_URL": "<MOODLE_URL>",
        "MOODLE_TOKEN": "<MOODLE_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "moodle-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "moodle-mcp"
      ],
      "env": {
        "MOODLE_URL": "<MOODLE_URL>",
        "MOODLE_TOKEN": "<MOODLE_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "moodle-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "moodle-mcp"
      ],
      "env": {
        "MOODLE_URL": "<MOODLE_URL>",
        "MOODLE_TOKEN": "<MOODLE_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "moodle-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "moodle-mcp"
      ],
      "env": {
        "MOODLE_URL": "<MOODLE_URL>",
        "MOODLE_TOKEN": "<MOODLE_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "moodle-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "moodle-mcp"
      ],
      "env": {
        "MOODLE_URL": "<MOODLE_URL>",
        "MOODLE_TOKEN": "<MOODLE_TOKEN>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • MOODLE_URLYour Moodle site URL, e.g. https://moodle.example.comRequired
  • MOODLE_TOKENWeb-service token from moodle-mcp authRequired

Tools this server provides (13)

Taken from the project documentation; the running server may differ.

list_courses
Finds a course.
get_course_overview
Returns a markdown map of a course.
get_assignment
Returns brief, attachments, submission and grade.
fetch_file
Converts a file URL to readable text.
upload_file
Uploads a file to the draft area.
submit_assignment
Saves a draft or turns in an assignment.
get_schedule
Lists deadlines in a time window.
get_grades
Returns graded items and feedback.
get_forum_discussions
Lists forum discussions.
get_discussion_posts
Returns posts in a discussion.
get_notifications
Returns notifications.
call_ws_function
Calls any Moodle web-service function (opt-in).
list_ws_functions
Lists available web-service functions (opt-in).

What it does

20 typed tools
Courses, assignments, forums, grades and files.
Draft submissions
Uploads stay drafts until finalized.
File-path based
Tools pass paths, not base64.
PDF to markdown
Reads assignment attachments including math.
Escape hatch
Opt-in call to other Moodle web-service functions.
Single binary
No runtime dependencies.

Good for

  • Ask what is due in the next two weeks
  • Build a study plan from deadlines
  • Catch up on a course's announcements
  • Draft and submit an assignment with confirmation

Pricing

Open source

MIT licensed

Moodle MCP FAQ

Which Moodle versions work?

3.7 through 5.x, verified on 3.7, 4.5 and 5.2.

Can it take quizzes?

No, quiz-taking is intentionally not provided.

How do I install it?

cargo install moodle-mcp, a prebuilt binary or a .mcpb bundle.

How is it authenticated?

With a token from moodle-mcp auth, set as MOODLE_TOKEN.

Is Moodle MCP free?

Yes. Moodle MCP is open source, so you can use and self-host it for free.

How do I add Moodle MCP to Claude Code?

Run this command in your terminal: claude mcp add moodle-mcp --env MOODLE_URL='<MOODLE_URL>' --env MOODLE_TOKEN='<MOODLE_TOKEN>' -- npx -y moodle-mcp

What are the best alternatives to Moodle MCP?

The closest alternatives to Moodle MCP are Penline Handwriting Sheets, Lumen, Education Mcp, Born Then and FreeDict.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers