Skip to content
MCP server

Moodle MCP

Ask about your Moodle assignments, deadlines, grades and forums through a read-only server

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, API
Runs
Locally
Version
0.1.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.

Aimed at students: the server uses your own Moodle web service token, so it sees what you see and nothing more, and it has no write tools. Typical questions are what is still to hand in this month, what is due this week and already submitted, or what your grade is in a given course.

It needs a Moodle 4.x site with web services or mobile app access enabled; the author developed against 4.5 and tested mainly with a student account, so teacher and admin roles, other versions and plugins are untested. Sites can switch off individual web service functions, in which case the matching tool simply returns an error. Large result sets are trimmed, with 25 assignments by default, to save context.

You can run it locally over stdio with npx, in Docker or Node, or deploy it to Cloudflare Workers behind a shared secret and add it to Claude as a custom connector. The README warns that anything the tools return, such as grades and names, goes into your conversation, so check your institution's rules on sharing academic data. It is unaffiliated with Moodle Pty Ltd.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "moodle-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@fabioov/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",
        "@fabioov/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",
        "@fabioov/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",
        "@fabioov/moodle-mcp"
      ],
      "env": {
        "MOODLE_URL": "<MOODLE_URL>",
        "MOODLE_TOKEN": "<MOODLE_TOKEN>"
      }
    }
  }
}

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

Configuration

  • MCP_TRANSPORTRun over stdio for local clients
  • MOODLE_URLRoot URL of your Moodle site, e.g. https://moodle.example.eduRequired
  • MOODLE_TOKENYour Moodle web service token (Preferences > Security keys)Required

Tools this server provides (9)

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

get_site_info
Validates the token and returns site, Moodle version and current user.
list_courses
Lists your courses, current ones by default.
get_course_contents
Lists sections and activities of a course.
list_assignments
Lists assignments with due dates.
get_assignment_status
Shows submission status, grade and feedback.
get_upcoming_deadlines
Lists calendar events and assignments due in the next N days.
get_grades
Returns grade items of a course.
list_forum_discussions
Lists recent discussions of a forum.
get_notifications
Returns recent Moodle notifications.

What it does

Deadline overview
Combines calendar events and assignments, marking each submitted or pending.
Assignment status
Shows submission state, grade and feedback comments.
Course contents
Lists a course's sections and activities.
Grades
Returns grade items for a course.
Forums and notifications
Reads recent forum discussions and Moodle notifications.
Flexible hosting
Runs over stdio, in Docker or Node, or on Cloudflare Workers.

Good for

  • See which assignments are still unsubmitted this month
  • Check what is due in the next two weeks
  • Look up grades in a single course
  • Catch up on announcements in a course forum
  • Browse the sections of a course

Pricing

Open source

Moodle MCP FAQ

Can it change anything in Moodle?

No. It is read-only by design and has no write tools.

What do I need?

A Moodle site with web services enabled, your own web service token and its URL, and Node 20 or newer, Docker or a Cloudflare account.

Which Moodle versions work?

Moodle 4.x is required; it was developed against 4.5 and mainly tested with a student account.

Is it official?

No. The README says it is not affiliated with or endorsed by Moodle Pty Ltd.

What licence is it?

MIT.

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 @fabioov/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