# Moodle MCP

> Moodle MCP is an open-source MCP server for education and exams. Moodle LMS for LLM agents: courses, assignments, files, forums and submissions. It runs locally on your machine and is started by your AI client.

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

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

## Tools

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

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

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