Moodle MCP
Ask about your Moodle assignments, deadlines, grades and forums through a read-only server
- Pricing
- Open source
- Platforms
- CLI, self-hosted, API
- Runs
- Locally
- Version
- 0.1.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.
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.
Install
Run in a terminal
claude mcp add moodle-mcp --env MOODLE_URL='<MOODLE_URL>' --env MOODLE_TOKEN='<MOODLE_TOKEN>' -- npx -y @fabioov/moodle-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"moodle-mcp": {
"command": "npx",
"args": [
"-y",
"@fabioov/moodle-mcp"
],
"env": {
"MOODLE_URL": "<MOODLE_URL>",
"MOODLE_TOKEN": "<MOODLE_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"moodle-mcp": {
"command": "npx",
"args": [
"-y",
"@fabioov/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",
"@fabioov/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",
"@fabioov/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",
"@fabioov/moodle-mcp"
],
"env": {
"MOODLE_URL": "<MOODLE_URL>",
"MOODLE_TOKEN": "<MOODLE_TOKEN>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
MCP_TRANSPORTRun over stdio for local clientsMOODLE_URLRoot URL of your Moodle site, e.g. https://moodle.example.eduRequiredMOODLE_TOKENYour Moodle web service token (Preferences > Security keys)Required
Tools this server provides (9)
Taken from the project documentation; the running server may differ.
- 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.
What it does
- 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
Pricing
Open source
Moodle MCP 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.