Moodle MCP for Students
Read-only integration with Moodle via the mobile web service, enabling AI apps to retrieve current courses, upcoming due dates, overdue items, assignments, grades, grade items, course content, and announcements.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Moodle MCP for StudentsWhat's due in the next two weeks, and is anything overdue?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Moodle MCP for students
Ask your AI what's actually left to do in Moodle.
This is a free, open source MCP server. It lets Claude, ChatGPT, Cursor and other AI apps read your Moodle courses, due dates, grades and announcements. It is read only. It can never submit, edit or delete anything.
Works with Moodle sites that have the mobile web service turned on. Not affiliated with Moodle Pty Ltd.
Free forever. No sign up and no subscription. Your login details only ever go to your own school.
Quick start
In Moodle, open your profile menu, go to Preferences > User account > Security keys. Copy the key for Moodle mobile web service.
Add this to your AI app's MCP config (for Claude Desktop that's
claude_desktop_config.json):
{
"mcpServers": {
"moodle": {
"command": "npx",
"args": ["-y", "moodle-student-mcp"],
"env": {
"MOODLE_BASE_URL": "https://moodle.yourschool.edu",
"MOODLE_TOKEN": "paste-your-key-here"
}
}
}
}Restart your AI app and ask something like "what's due this week?"
To check your setup first, run npx moodle-student-mcp doctor with the two environment variables set.
If you can't find a Security keys page, your school has turned off the mobile web service, or signs you in through single sign on without exposing keys. In that case this server can't connect to your account.
Related MCP server: Moodle Study MCP
What you can ask
"What's due in the next two weeks?"
"Is anything overdue?"
"What's my grade in each course, and what's in the gradebook for Networking?"
"Any new announcements?"
"Which assignments have I not submitted yet?"
Tools
All tools are read only.
Tool | What it does |
| Your current courses and their IDs |
| Everything due in the next 60 days, soonest first |
| Past due items that still need action |
| Assignments for a course with due dates and submission status |
| Current grade for each course |
| Every graded item in a course with mark and percentage |
| Sections and activities for a course |
| Recent announcements |
Privacy and security
Your key stays on your computer. It is only sent to your own school's Moodle address.
Nothing is sent to any other server by this project.
Every tool is marked read only. You can reset your key any time on the Security keys page.
Troubleshooting
Message | Fix |
Not signed in | Your key expired or was reset. Copy the new one. |
Access denied | Your school turned that feature off for students. |
Web services not enabled | Your school hasn't turned on the mobile web service. |
Not found | Check the course ID with |
Development
npm install
npm run build
npm testTests run against a fake Moodle server, so they need no account or network.
More free student MCP servers
All free, open source and read only where they touch your accounts. Browse the full list at brightspacemcp.com/more-mcps.
Server | What it does |
D2L Brightspace for AI. Due dates with real submission status, grades, a target grade calculator and course files. | |
Read-only Canvas LMS for AI. Due dates, missing work, grades and announcements. | |
Read-only Google Classroom for AI. To-do, due dates, missing work and grades. | |
GPA, grade conversion and what-do-I-need-on-the-final math for AI. Works offline, no account. | |
APA, MLA and Chicago citations from a DOI, an ISBN or typed details. No account. | |
Exam study schedules, spaced repetition dates, pomodoro plans and assignment milestones. Works offline. | |
Search scholarly papers, find open access copies and related work through OpenAlex. No key needed. |
License
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
Read-only access to Epivo's live course catalogue for AI agents.
Connect your Moodle to AI assistants: courses, content, grading and reports from the chat.
Search university course materials, your flashcards, quizzes, streak and quota. All tools read-only.
Read-only access to your CodeMouse accounts, repositories, and AI pull-request reviews.
Related MCP Servers
- FlicenseAqualityDmaintenanceEnables read-only querying of Moodle as a student, including courses, assignments, grades, forums, and files, using a personal web services token.11-
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to read your Moodle courses, list materials, quizzes, and search content to plan exam preparation through natural language.1-
- AlicenseNot gradedqualityBmaintenanceEnables Claude to interact with Moodle via the official REST API for read-only tasks like listing courses, materials, assignments, submissions, and grades. Uses token-based authentication and emphasizes safe, no-write operations.2MIT
- AlicenseAqualityCmaintenanceEnables AI agents to access a student's EPFL Moodle data—deadlines, course files, assignments, forums, and grades—through read-only tools.12MIT