Skip to main content
Glama

Moodle MCP Server

An MCP (Model Context Protocol) server that enables LLMs to interact with the Moodle platform to manage courses, students, assignments, and quizzes.

Features

Student Management Tools

  • list_students - Retrieves the list of students enrolled in the course

    • Displays ID, name, email, and last access time for each student

Assignment Management Tools

  • get_assignments - Retrieves all available assignments in the course

    • Includes information such as ID, name, description, due date, and maximum grade

  • get_student_submissions - Examines a student's submissions for a specific assignment

    • Requires the assignment ID and optionally the student ID

  • provide_assignment_feedback - Provides grades and comments for a student's submission

    • Requires student ID, assignment ID, grade, and feedback comment

Quiz Management Tools

  • get_quizzes - Retrieves all available quizzes in the course

    • Includes information such as ID, name, description, opening/closing dates, and maximum grade

  • get_quiz_attempts - Examines a student's attempts on a specific quiz

    • Requires the quiz ID and optionally the student ID

  • provide_quiz_feedback - Provides comments for a quiz attempt

    • Requires the attempt ID and feedback comment

Related MCP server: Moodle MCP

Requirements

  • Node.js (v14 or higher)

  • Moodle API token with appropriate permissions

  • Moodle course ID

Installation

  1. Clone this repository:

git clone https://github.com/your-username/moodle-mcp-server.git
cd moodle-mcp-server
  1. Install dependencies:

npm install
  1. Create a .env file with the following configuration:

MOODLE_API_URL=https://your-moodle.com/webservice/rest/server.php
MOODLE_API_TOKEN=your_api_token
MOODLE_COURSE_ID=1  # Replace with your course ID
  1. Build the server:

npm run build

Usage with Claude

To use with Claude Desktop, add the server configuration:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "moodle-mcp-server": {
      "command": "/path/to/node",
      "args": [
        "/path/to/moodle-mcp-server/build/index.js"
      ],
      "env": {
        "MOODLE_API_URL": "https://your-moodle.com/webservice/rest/server.php",
        "MOODLE_API_TOKEN": "your_moodle_api_token",
        "MOODLE_COURSE_ID": "your_course_id"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

For Windows users, the paths would use backslashes:

{
  "mcpServers": {
    "moodle-mcp-server": {
      "command": "C:\\path\\to\\node.exe",
      "args": [
        "C:\\path\\to\\moodle-mcp-server\\build\\index.js"
      ],
      "env": {
        "MOODLE_API_URL": "https://your-moodle.com/webservice/rest/server.php",
        "MOODLE_API_TOKEN": "your_moodle_api_token",
        "MOODLE_COURSE_ID": "your_course_id"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Once configured, Claude will be able to interact with your Moodle course to:

  • View the list of students and their submissions

  • Provide comments and grades for assignments

  • Examine quiz attempts and offer feedback

Development

For development with auto-rebuild:

npm run watch

Debugging

MCP servers communicate through stdio, which can make debugging challenging. We recommend using the MCP Inspector:

npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.

Obtaining a Moodle API Token

  1. Log in to your Moodle site as an administrator

  2. Go to Site Administration > Plugins > Web Services > Manage tokens

  3. Create a new token with the necessary permissions to manage courses

  4. Copy the generated token and add it to your .env file

Security

  • Never share your .env file or Moodle API token

  • Ensure the MCP server only has access to the courses it needs to manage

  • Use a token with the minimum necessary permissions

License

MIT

Available Tools

7 tools
get_assignmentsB

Obtiene la lista de tareas asignadas en el curso configurado

Inputs: no named parameters.

get_quiz_gradeB

Obtiene la calificación de un estudiante en un quiz específico

Inputs: studentId (required), quizId (required).

get_quizzesB

Obtiene la lista de quizzes en el curso configurado

Inputs: no named parameters.

get_studentsB

Obtiene la lista de estudiantes inscritos en el curso configurado

Inputs: no named parameters.

get_submission_contentC

Obtiene el contenido detallado de una entrega específica, incluyendo texto y archivos adjuntos

Inputs: studentId (required), assignmentId (required).

get_submissionsC

Obtiene las entregas de tareas en el curso configurado

Inputs: studentId, assignmentId.

provide_feedbackC

Proporciona feedback sobre una tarea entregada por un estudiante

Inputs: studentId (required), assignmentId (required), feedback (required), grade.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 7 tools

    Disambiguation4/5

    Most tools have distinct purposes targeting different Moodle resources like assignments, quizzes, students, and submissions, but get_submissions and get_submission_content could be slightly confusing as the latter seems like a more detailed version of the former. The descriptions clarify the difference, but some overlap exists.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern using snake_case, starting with 'get_' for retrieval operations and 'provide_' for feedback. This uniformity makes the set predictable and easy to navigate for an agent.

    Tool Count4/5

    With 7 tools, the count is reasonable for a Moodle server focused on course management tasks. It covers core operations like retrieving assignments, quizzes, students, and submissions, though it might be slightly thin if more advanced features like creating or updating resources are expected.

    Completeness3/5

    The server provides good read-only coverage for viewing course elements and feedback, but lacks create, update, or delete operations for resources like assignments or quizzes. This creates notable gaps in CRUD functionality, which could limit agent workflows in a full course management context.

    Related MCP Connectors

    Related MCP Servers