moodle-mcp
Provides read-only access to a Moodle instance, including courses, course contents and files, upcoming deadlines, assignments and submission status, grades, forum discussions, and downloading course files.
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-mcp
מדברים עם ה-Moodle. שרת MCP קטן שנותן ל-Claude לקרוא את הקורסים, המטלות, הציונים והקבצים שלכם — שואלים במקום ללחוץ.

הדמו משתמש בנתוני דוגמה. הסרטון המלא
"מה יש לי להגיש השבוע?" "תוריד לי את שיעורי הבית החדשים במעגלים אנלוגיים" "יש הודעות חדשות מהמרצים?" "תסביר לי את הפרויקט החדש במבנה המחשב"
נבנה באוניברסיטת תל אביב, עם הגדרות מוכנות ל-37 אוניברסיטאות ומכללות בארץ. לקריאה בלבד: לא מגיש, לא מפרסם ולא משנה שום דבר.
⚡ הדרך הקלה: תנו ל-Claude להתקין
פותחים את Claude Code וכותבים לו:
אני לומד בטכניון, תתקין לי את https://github.com/raztassa2000-eng/moodle-mcpמשם Claude יוריד את הפרויקט, יתקין אותו, יבחר את המוסד שלכם ויחבר את השרת ל-Claude Code, וגם ל-Claude Desktop אם הוא מותקן אצלכם. בסוף הוא יבקש מכם דבר אחד: להריץ פקודת התחברות אחת בטרמינל (שלב 2 למטה). סיסמה ומפתח לא מדביקים בצ'אט.
איפה זה עובד: ב-Claude Code וב-Claude Desktop (מק וווינדוס). השרת רץ על המחשב שלכם, ולכן הוא לא זמין באתר claude.ai ובאפליקציה בטלפון.
Related MCP server: Moodle MCP Server
🧰 מה הוא יודע לעשות
כלי | מה הוא עושה |
| מה התחדש בכל הקורסים בימים האחרונים: קבצים, מטלות והודעות, בקריאה אחת |
| הקורסים שאתם רשומים אליהם |
| יחידות, פעילויות וקבצים של קורס |
| מטלות ובחנים בימים הקרובים |
| כל מה שבלוח השנה של Moodle: מבחנים, אירועים ומועדי הגשה |
| תאריכי הגשה, סטטוס ההגשה שלכם, הציון, הערות הבודק וקבצים מצורפים |
| בחנים: מועדי פתיחה וסגירה, הגבלת זמן, הניסיונות והציון שלכם |
| הציונים שלכם בקורס |
| הציון הסופי בכל הקורסים, בקריאה אחת |
| הודעות אחרונות בפורומים ובלוח ההודעות |
| שרשור מלא בפורום, כולל כל התגובות |
| ההתראות שלכם ב-Moodle (הפעמון) |
| שמירת קובץ מהקורס ל- |
| הורדת כל הקבצים של קורס לתיקייה מסודרת לפי יחידות; קבצים שכבר ירדו ולא השתנו מדולגים |
🚀 התקנה ידנית
1. מורידים ומתקינים
git clone https://github.com/raztassa2000-eng/moodle-mcp.git
cd moodle-mcp
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt2. מתחברים
מריצים בטרמינל מתוך תיקיית moodle-mcp (בטרמינל חדש, קודם cd אליה), ומחליפים את tau במפתח של המוסד שלכם:
.venv/bin/pip install playwright
MOODLE_SITE=tau .venv/bin/python moodle_mcp.py --loginהכלי בוחר לבד את דרך ההתחברות של המוסד שלכם:
בדפדפן: נפתח חלון של Chrome או Edge, ומתחברים כרגיל עם פרטי האוניברסיטה. ככה זה בתל אביב, בטכניון ובעוד 20 מוסדות.
שם משתמש וסיסמה: הכלי שואל אותם בטרמינל. הסיסמה מוסתרת, נשלחת רק ל-Moodle של המוסד ולא נשמרת. ככה זה בבן-גוריון, בבצלאל, ברופין ועוד.
בשתי הדרכים לא צריך ללחוץ על "איפוס". מקבלים את המפתח הקיים, כך שאפליקציית Moodle בטלפון נשארת מחוברת. המפתח נשמר בקובץ .token, שלא נכנס ל-git, ולא מוצג על המסך. נבדק מקצה לקצה רק בתל אביב.
ב-Moodle: תמונת הפרופיל ← העדפות ← מפתחות אבטחה. בשורה של Moodle mobile web service לוחצים על איפוס, ורק אז מוצג המפתח המלא. מעתיקים אותו ומריצים בתיקיית הפרויקט את הפקודה שמתאימה למחשב שלכם:
במק:
pbpaste > .token && chmod 600 .tokenבווינדוס (PowerShell):
Get-Clipboard | Set-Content .token
שימו לב: איפוס מבטל את המפתח הקודם, כך שאפליקציית Moodle בטלפון עשויה לבקש התחברות מחדש. אפשר גם להשתמש במשתנה הסביבה MOODLE_TOKEN.
3. מחברים ל-Claude
ב-Claude Code (מחליפים את tau במפתח של המוסד שלכם):
claude mcp add moodle -s user -e MOODLE_SITE=tau -- "$PWD/.venv/bin/python" "$PWD/moodle_mcp.py"ב-Claude Desktop פותחים הגדרות ← Developer ← Edit Config, מוסיפים את הבלוק הבא לקובץ claude_desktop_config.json ומפעילים מחדש את האפליקציה. אם כבר יש בקובץ mcpServers, מוסיפים רק את moodle לתוכו.
הקובץ נמצא כאן:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.jsonוזה הבלוק שמוסיפים:
{
"mcpServers": {
"moodle": {
"command": "/full/path/to/moodle-mcp/.venv/bin/python",
"args": ["/full/path/to/moodle-mcp/moodle_mcp.py"],
"env": { "MOODLE_SITE": "tau" }
}
}
}🔌 עובד גם עם אפליקציות אחרות
MCP הוא סטנדרט פתוח, אז מה שקובע זה האפליקציה ולא המודל. כל אפליקציה שמריצה שרתי MCP מקומיים יכולה להשתמש בו, עם GPT, עם Gemini או אפילו עם מודל שרץ אצלכם במחשב. מוסיפים את אותו בלוק JSON משלב 3 לקובץ ההגדרות של האפליקציה:
אפליקציה | איפה מגדירים |
Cursor |
|
Windsurf |
|
Gemini CLI |
|
LM Studio | בתוך האפליקציה: Program ← Install ← Edit mcp.json |
VS Code (Copilot, מצב agent) |
|
Codex CLI |
|
[mcp_servers.moodle]
command = "/full/path/to/moodle-mcp/.venv/bin/python"
args = ["/full/path/to/moodle-mcp/moodle_mcp.py"]
env = { MOODLE_SITE = "tau" }נבדק רק ב-Claude Code; האחרות לפי מה שהן תומכות בו. לא עובד ב-ChatGPT, ב-Gemini באתר, ב-claude.ai ובאפליקציות בטלפון: הן מתחברות רק לשרתים שמתארחים באינטרנט, והשרת הזה רץ על המחשב שלכם.
🏫 בוחרים מוסד
מגדירים את MOODLE_SITE לאחד מהמפתחות הבאים (ברירת המחדל: tau).
אוניברסיטאות
tau תל אביב · technion הטכניון · bgu בן-גוריון · ariel אריאל · openu האוניברסיטה הפתוחה
מכללות להנדסה, עיצוב וכלליות
hit HIT חולון · sce סמי שמעון · braude בראודה · azrieli עזריאלי ירושלים · jct המרכז האקדמי לב · shenkar שנקר · bezalel בצלאל · jamd האקדמיה למוסיקה ולמחול · mta האקדמית תל אביב-יפו · colman המכללה למינהל · ruppin רופין · kinneret כנרת · wgalil גליל מערבי · achva אחוה · zefat צפת · schechter מכון שכטר
מכללות לחינוך
smkb סמינר הקיבוצים · levinsky לוינסקי · wingate וינגייט · beitberl בית ברל · oranim אורנים · dyellin דוד ילין · kaye קיי · washington גבעת ושינגטון · talpiot תלפיות · shaanan שאנן · orot אורות ישראל · efrata אפרתה · hemdat חמדת · sakhnin סכנין · qsm אלקאסמי · arabcol המכללה האקדמית הערבית לחינוך, חיפה
המוסד שלכם לא ברשימה? אצל העברית, בר-אילן, חיפה, רייכמן, אפקה, ספיר, תל-חי ואחרים ה-Moodle יושב מאחורי מסך התחברות או הגנת בוטים, ולכן לא ניתן היה לבדוק את הכתובת אוטומטית. מגדירים במקום זה את MOODLE_URL לכתובת ה-Moodle שלכם — ומוזמנים לפתוח PR שמוסיף אותה.
כדאי לדעת:
כל 37 האתרים נבדקו כאתרי Moodle פעילים (נובמבר 2026), אבל רק תל אביב נבדקה מקצה לקצה עם token אמיתי. האם אפשר להוציא token תלוי בהגדרות של כל מוסד.
חלק מהמוסדות פותחים Moodle חדש כל שנה (
moodle26…,moodle27…), ולכן הכתובות האלה דורשות עדכון שנתי.
🧠 Skill (לא חובה)
בתיקייה skills/moodle יש קובץ SKILL.md שמלמד את Claude מתי להשתמש בכל כלי: למשל לבדוק דדליינים לפני שהוא בונה תוכנית לימודים, ולעולם לא להגיש כלום. ב-Claude Code מעתיקים אותו כך:
mkdir -p ~/.claude/skills && cp -r skills/moodle ~/.claude/skills/⚙️ הגדרות
משתנה | ברירת מחדל | משמעות |
|
| מפתח המוסד מהרשימה למעלה |
| – | כתובת של כל Moodle אחר (גובר על |
| – | ה-token (גובר על הקובץ |
|
| מאיפה לקרוא את ה-token |
|
| לאן נשמרות ההורדות |
🔒 אבטחה
ה-token שווה ערך לסיסמה לקריאת ה-Moodle שלכם. לא מעלים אותו ל-git ולא מדביקים אותו בצ'אט.
ב-
--loginהסיסמה עוברת רק ל-Moodle של המוסד ולא נשמרת. המפתח שחוזר נבדק לפני שהוא נשמר.ה-token נשלח רק לשרת ה-Moodle שהוגדר. הורדה מכל כתובת אחרת נחסמת.
הורדות לא יכולות לצאת מתיקיית ההורדות.
🇬🇧 English
Talk to your Moodle. A tiny MCP server that lets Claude read your courses, deadlines, grades and files — so you can ask instead of click. Read-only by design: it never submits, posts or changes anything.
Built at Tel Aviv University, with presets for 37 Israeli universities and colleges — and it works with any other Moodle that hands out a web service token.
⚡ The easy way: let Claude install it
Open Claude Code and say:
Install https://github.com/raztassa2000-eng/moodle-mcp for me — I study at the TechnionClaude clones, installs, picks your institution and connects the server. You only save the token yourself (step 2 below) — never paste it into the chat.
🚀 Manual setup
git clone https://github.com/raztassa2000-eng/moodle-mcp.git
cd moodle-mcp
python3 -m venv .venv
.venv/bin/pip install -r requirements.txtLog in (replace tau with your institution's key):
.venv/bin/pip install playwright
MOODLE_SITE=tau .venv/bin/python moodle_mcp.py --loginIt picks your institution's login method by itself: a Chrome/Edge window where you log in as usual (TAU, Technion and 20 others), or your Moodle username and password typed into the terminal (hidden, sent only to your Moodle, never stored). Either way you get your existing key, with no Reset, so the Moodle phone app stays logged in. The key goes into .token and is never printed. Only TAU has been tested end to end.
Didn't work? In Moodle, profile picture → Preferences → Security keys, click Reset on the Moodle mobile web service row (the full key only shows after a reset; this logs the phone app out), copy it and run pbpaste > .token && chmod 600 .token on macOS, or Get-Clipboard | Set-Content .token in PowerShell on Windows.
Connect (replace tau with your institution's key from the list above):
claude mcp add moodle -s user -e MOODLE_SITE=tau -- "$PWD/.venv/bin/python" "$PWD/moodle_mcp.py"For Claude Desktop, add the JSON block shown above to claude_desktop_config.json (Settings → Developer → Edit Config; on macOS it lives in ~/Library/Application Support/Claude/, on Windows in %APPDATA%\Claude\) and restart the app. The server runs on your own computer, so it works in Claude Code and Claude Desktop but not on claude.ai in the browser or in the phone app.
Tools: whats_new (everything that changed across your courses, in one call), list_courses, course_contents, upcoming_deadlines, calendar_events, assignments (with grade and grader feedback), quizzes, grades, grades_overview, forum_discussions, forum_thread, notifications, download_file and download_course (a whole course into one folder, skipping files you already have).
Run .venv/bin/python moodle_mcp.py --sites for the full list of institutions with names and URLs; for anything not listed, set MOODLE_URL.
Other apps: MCP is an open standard, so any app that runs local MCP servers works, whatever model it uses. Add the same JSON block to Cursor (~/.cursor/mcp.json), Windsurf (~/.codeium/windsurf/mcp_config.json), Gemini CLI (~/.gemini/settings.json) or LM Studio (Program → Install → Edit mcp.json). VS Code uses .vscode/mcp.json with a top-level servers key and "type": "stdio"; Codex CLI uses the TOML block above in ~/.codex/config.toml. Only Claude Code has been tested. It does not work in ChatGPT, Gemini on the web, claude.ai or phone apps, which only connect to servers hosted on the internet.
All 37 sites were checked to be live Moodle sites (November 2026), but only TAU has been tested end to end with a real token.
🤖 Instructions for Claude (automatic install)
If a user gave you this repository and asked you to install it, do this:
Clone the repo to a sensible permanent location (ask if unsure), create
.venv, andpip install -r requirements.txt. Python 3.10+ is required.Map the institution the user named to a key: run
.venv/bin/python moodle_mcp.py --sites. If it isn't listed, ask the user for their Moodle address and useMOODLE_URLinstead ofMOODLE_SITE.Register the server with absolute paths:
claude mcp add moodle -s user -e MOODLE_SITE=<key> -- <repo>/.venv/bin/python <repo>/moodle_mcp.pyIf Claude Desktop is installed (itsclaude_desktop_config.jsonexists:~/Library/Application Support/Claude/on macOS,%APPDATA%\Claude\on Windows), also add the server there: back the file up, then add amoodleentry undermcpServerswith the samecommand,argsandenv, keeping every other key untouched. Tell the user to restart Claude Desktop.Do not ask for the token or password in chat and do not read
.token. Installplaywrightinto the venv, then ask the user to run this in their own terminal (it may open a browser window or prompt for a hidden password):cd <repo> && MOODLE_SITE=<key> .venv/bin/python moodle_mcp.py --login. If that fails, the fallback is manual: Moodle → Preferences → Security keys → Reset on the Moodle mobile web service row, copy, andpbpaste > <repo>/.token && chmod 600 <repo>/.token(on Windows/Linux, save it to that file with their own editor).Install the skill:
mkdir -p ~/.claude/skills && cp -r <repo>/skills/moodle ~/.claude/skills/.After they confirm, verify with
MOODLE_SITE=<key> .venv/bin/python -c "import moodle_mcp as m; print(len(m.list_courses()), 'courses')", then tell them to start a new session so the tools load.If verification fails with
invalidtokenor a web-service error, say so plainly: their institution may not issue tokens to students. Do not try to obtain a token another way.
עזר לכם? תנו ⭐ לריפו כדי שעוד סטודנטים ימצאו אותו.
If this helped you, a ⭐ helps other students find it.
MIT License · Not affiliated with any university, college or Moodle.
Tool 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
An MCP server that provides read access to your cloud storage providers, bank accounts and more.
Read-only MCP server for ClassQuill, a tutoring-business-management platform.
Free WhatsApp MCP server for ChatGPT and Claude: read and search chats, every send you approve.
Talk to your public-facing AI from any MCP client — Claude, ChatGPT, Cursor, Cline, Windsurf.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMoodle REST API client with batch downloading and MCP protocol support for Claude Code and OpenCode, enabling course management, grade checking, assignment tracking, file downloads, and more.6MIT
- AlicenseNot gradedqualityDmaintenanceA powerful Model Context Protocol (MCP) server that seamlessly integrates AI assistants with Moodle Learning Management System. Enable your AI assistant to access courses, retrieve educational content, download resources, and search through your learning materials.1MIT
- FlicenseNot gradedqualityBmaintenanceA Model Context Protocol (MCP) server that connects AI coding agents to your Moodle LMS. Fetch assignments, grades, deadlines, and sync everything to Obsidian automatically.-
- AlicenseBqualityBmaintenanceConnects MCP-compatible AI clients to a university Moodle campus locally so users can query courses, assignments, materials, grades, forums, and calendar events, including reading attachments and PDFs. It is a read-only beta that does not modify the campus or store passwords.404MIT