Moodle MCP Server

- Course management with pagination and optional filtering by course ID
- Student management: list enrolled students with ID, name, email, last access
- Assignment management: view assignments, submissions, and provide graded feedback
- Quiz management: list quizzes, view student attempts, and offer comments
- All tools operate via the Moodle Web Services REST API
- Configurable for any Moodle site using an API token

- Node.js (v14 or higher)
- Moodle API token with appropriate permissions
- Moodle course ID

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

- get_courses - Retrieves information about courses in Moodle
- Supports pagination (page, limit) to safely fetch all available courses.
- Optionally allows fetching a specific course by providing a courseId.

- list_students - Retrieves the list of students enrolled in the course
- Displays ID, name, email, and last access time for each student

- 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

- 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