Moodle MCP
Moodle LMS for LLM agents: courses, assignments, files, forums and submissions
- Pricing
- Open source
- Platforms
- CLI, Linux, macOS
- Runs
- Locally
- Version
- 0.2.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.
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.
Install
Run in a terminal
claude mcp add moodle-mcp --env MOODLE_URL='<MOODLE_URL>' --env MOODLE_TOKEN='<MOODLE_TOKEN>' -- npx -y moodle-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"moodle-mcp": {
"command": "npx",
"args": [
"-y",
"moodle-mcp"
],
"env": {
"MOODLE_URL": "<MOODLE_URL>",
"MOODLE_TOKEN": "<MOODLE_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"moodle-mcp": {
"command": "npx",
"args": [
"-y",
"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",
"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",
"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",
"moodle-mcp"
],
"env": {
"MOODLE_URL": "<MOODLE_URL>",
"MOODLE_TOKEN": "<MOODLE_TOKEN>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
MOODLE_URLYour Moodle site URL, e.g. https://moodle.example.comRequiredMOODLE_TOKENWeb-service token from moodle-mcp authRequired
Tools this server provides (13)
Taken from the project documentation; the running server may differ.
- 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).
What it does
- 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
Pricing
Open source
MIT licensed
Moodle MCP 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.