# Moodle MCP

> Moodle MCP is an open-source MCP server for education and exams. Ask about your Moodle assignments, deadlines, grades and forums through a read-only server. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, API
- **Repository:** https://github.com/fabioov/moodle-mcp
- **MCP Registry name:** io.github.fabioov/moodle-mcp
- **Categories:** [education and exams](https://ai-powered.com/categories/education-and-exams)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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.

## Alternatives

- [Penline Handwriting Sheets](https://ai-powered.com/mcp/penline-handwriting-sheets): Penline Handwriting Sheets is an MCP server for education and exams.
- [Lumen](https://ai-powered.com/mcp/lumen-4): Lumen is an open-source MCP server for education and exams.
- [Education Mcp](https://ai-powered.com/mcp/education-mcp): Education Mcp is a freemium MCP server for education and exams.
- [Born Then](https://ai-powered.com/mcp/born-then): Born Then is a free MCP server for education and exams.
- [FreeDict](https://ai-powered.com/mcp/freedict): FreeDict is a freemium MCP server for language learning.
- [Extraudinary](https://ai-powered.com/mcp/extraudinary): Extraudinary is a freemium MCP server for education and exams.
- [Scormbusters](https://ai-powered.com/mcp/scormbusters): Scormbusters is an MCP server for education and exams.
- [Dengdeng Chinese Dictionary](https://ai-powered.com/mcp/dengdeng-chinese-dictionary): Dengdeng Chinese Dictionary is a free MCP server for language learning.

---
Source: https://ai-powered.com/mcp/moodle-mcp-2
