Moodle Study MCP
Allows interaction with Moodle, providing tools to list courses, get course overview with content counts, sync and search materials, and list quizzes with attempt information.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Moodle Study MCP
An MCP server that lets Claude read your ETH Moodle courses so it can plan your exam prep. Ask Claude things like:
"For Control Systems II, exam in 12 days — how many lectures, problem sets, quizzes and practice exams do I have, and what should I actually do?"
The server fetches, counts, and categorizes your course content. Claude does the
reasoning. Works for any Moodle site (defaults to ETH; set MOODLE_URL for others).
What it gives Claude
Tool | What it does |
| Your enrolled courses |
| Detected counts (lectures / problem sets / practice exams / quizzes) + the raw item list |
| Downloads + text-extracts all materials into a local cache |
| Every quiz + how many attempts you've made |
| Full-text search across everything you've synced |
| The extracted text of one file, for Claude to read |
Related MCP server: FCPC-lms-mcp-server
Setup (ETH students)
Requires Python 3.10+.
git clone <this-repo> && cd Moodle-MCP
pip install -e .1. Get your token (once)
ETH uses SSO, so you need a Moodle web-service token (a 32-character hex string). The token is stored in your OS keyring (never in a file, never in git) and is long-lived.
python -m moodle_mcp authThis opens a browser; log in with SSO. At the end Moodle tries to hand the token
back via a moodlemobile://token=... redirect. Since no app is registered for
the moodlemobile:// scheme, your browser shows an error — "address invalid"
(or "Safari cannot open the page because the address is invalid"). That's
expected. You just need to fish the token=... value out of that failed
redirect and paste it at the prompt.
Most browsers (Safari and Chrome included) hide the failed URL, so grab it from DevTools instead:
Safari — enable Settings → Advanced → "Show features for web developers", then Develop → Show Web Inspector (
⌥⌘I) → Network tab. Run the login, click thelaunch.phpentry → Response, and search formoodlemobile://token=. Copy that whole value.Chrome / Edge —
Ctrl/⌘+Shift+I→ Network tab → run the login → open thelaunch.phpresponse and findtoken=.
Paste that value at the Paste the moodlemobile://token=... value here: prompt
(the tool decodes it for you).
Non-ETH Moodle sites: many expose the token directly under your profile → Preferences → Security keys (
<your-moodle>/user/managetoken.php), listed as "Moodle mobile web service". If it's there, skip the browser dance:python -m moodle_mcp auth --token <token>. Note: the RSS token on that page is not the right one, and ETH does not list the mobile token there.
Verify:
python -m moodle_mcp doctor2. Register with Claude Code
claude mcp add moodle -- python -m moodle_mcp serveThen in Claude: "List my Moodle courses", or "Give me a study overview of Fluid Dynamics."
Other universities
export MOODLE_URL="https://moodle.your-uni.example"
python -m moodle_mcp authThe classifier keywords (taxonomy.yaml) are tuned for German + English ETH
naming. Add your own patterns there if your course names differ.
Privacy & security
Your token is a password to your Moodle account. It lives only in your OS keyring.
.gitignoreexcludes the cache and any token files.The local cache (
~/.moodle-mcp/) holds copyrighted course material — it stays on your machine.Uses only Moodle's sanctioned mobile web-service API. No scraping.
Development
pip install -e ".[dev]"
pytestTool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Create, edit, translate, and export SCORM eLearning modules from a connected AI assistant.
Read-only access to Epivo's live course catalogue for AI agents.
Lucky AI study buddy over your own LlamaNotes courses: chat, progress, and AI course generation.
Your AI professor for Helmley courses: reads your course and progress, teaches and sends plans.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI assistants to interact with Moodle via web services, allowing tasks like listing courses, assignments, events, and downloading files.1032 PyPI4MIT
- FlicenseNot gradedqualityCmaintenanceEnables AI assistants to query and manage Moodle LMS data, including assignment deadlines, unread messages, unfinished quizzes, and enrolled courses, using natural language via OpenAI or local LLMs.-
- AlicenseAqualityBmaintenanceEnables AI apps to read a student's Moodle courses, upcoming and overdue due dates, assignment submission statuses, course grades, gradebook items and announcements. It is strictly read only, so it can never submit, edit or delete anything.17206 npmMIT
- AlicenseAqualityCmaintenanceEnables AI assistants to securely read course outlines, deadlines, announcements, forum discussions, and files from Moodle, track changes, and download or mirror course materials with a personal read-only token.101MIT