English Français العربية

Moodle MCP

السجل الرسمي أخرى

Read-only Moodle server: assignments, deadlines, grades, courses, forums, notifications.

الشيفرة المصدرية التوثيق

ماذا يمكنك أن تفعل مع Moodle MCP؟

  • "Which assignments do I still have to hand in this month?"
  • "What's due this week, and what have I already submitted?"
  • "What are my grades in Machine Learning?"
  • "Any new announcements in my courses?"
  • "Show me the sections and activities of my Computer Graphics course."

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @fabioov/moodle-mcp
Claude Code 
claude mcp add moodle-mcp -e 'MCP_TRANSPORT=<MCP_TRANSPORT>' -e 'MOODLE_URL=<MOODLE_URL>' -e 'MOODLE_TOKEN=<your moodle_token>' -- npx -y @fabioov/moodle-mcp@0.1.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "moodle-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@fabioov/moodle-mcp@0.1.1"
            ],
            "env": {
                "MCP_TRANSPORT": "<MCP_TRANSPORT>",
                "MOODLE_URL": "<MOODLE_URL>",
                "MOODLE_TOKEN": "<your moodle_token>"
            }
        }
    }
}

متغيرات البيئة

  • MCP_TRANSPORT Run over stdio for local clients
  • MOODLE_URL إلزامي Root URL of your Moodle site, e.g. https://moodle.example.edu
  • MOODLE_TOKEN إلزامي سري Your Moodle web service token (Preferences > Security keys)

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Moodle MCP
  2. What you can ask
  3. Tools
  4. Requirements
  5. Setup
  6. Security and privacy
  7. Known limitations
  8. Development
  9. License

Moodle MCP

An open source, read-only MCP server for Moodle. Connect it to Claude and ask about your assignments, deadlines, grades, courses, forums and notifications in plain language.

Not affiliated with or endorsed by Moodle Pty Ltd. "Moodle" is a trademark of its owner.

What you can ask

  • "Which assignments do I still have to hand in this month?"
  • "What's due this week, and what have I already submitted?"
  • "What are my grades in Machine Learning?"
  • "Any new announcements in my courses?"
  • "Show me the sections and activities of my Computer Graphics course."

Tools

All tools are read-only and return concise, readable output.

ToolWhat it doesParameters
get_site_infoValidates the token; site, Moodle version and current user–
list_coursesYour courses (current ones by default)includePast?
get_course_contentsSections and activities of a course. Each module has id and instancecourseId
list_assignmentsAssignments with due dates, sorted by due datecourseId?, upcomingOnly?, limit? (25)
get_assignment_statusSubmission/grading status, grade and feedback commentsassignmentId
get_upcoming_deadlinesCalendar events + assignments in the next N days, each assignment marked submitted or pendingdays? (14), onlyPending?
get_gradesGrade items of a coursecourseId
list_forum_discussionsRecent discussions of a forumforumId (the instance from get_course_contents)
get_notificationsRecent Moodle notifications–

Requirements

  • A Moodle site with Web Services / mobile app access enabled (Moodle 4.x; developed against 4.5).
  • Your own web service token (below). Functions your institution disables simply return an error for that tool.
  • Node 20+ for the server (Node 22+ to deploy with Wrangler), or Docker, or a free Cloudflare account.

Setup

1. Get your Moodle URL and token
  • URL: the root of your Moodle, without a page or /webservice, e.g. https://moodle.example.edu (if Moodle lives in a subfolder, include it: https://example.edu/moodle).
  • Token: in Moodle, Preferences → Security keys shows a key for Moodle mobile web service. Some sites only show a label there; Reset generates a new key (and signs out your Moodle mobile app). Alternatively, if you log in with a Moodle username and password (not SSO), request one: curl -s "$MOODLE_URL/login/token.php" -d username=... --data-urlencode password=... -d service=moodle_mobile_app (type the password interactively so it doesn't end up in your shell history).
2. Configure

Copy .env.example to .env and fill in MOODLE_URL, MOODLE_TOKEN and MCP_AUTH_SECRET (generate the latter with openssl rand -hex 24). .env is git-ignored.

3. Run it, pick one

Cloudflare Workers (free, always on, no domain needed): recommended

npm ci
npx wrangler login
npx wrangler secret put MOODLE_URL        # https://your.moodle.edu
npx wrangler secret put MOODLE_TOKEN      # your Moodle web service token
npx wrangler secret put MCP_AUTH_SECRET   # openssl rand -hex 24
npm run deploy                            # prints https://moodle-mcp.<you>.workers.dev

Check Cloudflare's current free-tier limits. Try it locally first by copying your .env values to a git-ignored .dev.vars and running npm run dev:worker.

Docker / Node (self-hosted)

docker build -t moodle-mcp . && docker run --env-file .env -p 3000:3000 moodle-mcp
# or: npm ci && npm run build && npm start

Then expose it over HTTPS (for example with a Cloudflare Tunnel or Tailscale Funnel).

Local only (Claude Desktop / Claude Code, stdio): no install needed:

MCP_TRANSPORT=stdio MOODLE_URL=https://your.moodle.edu MOODLE_TOKEN=... npx -y @fabioov/moodle-mcp

MCP_AUTH_SECRET is not needed in this mode.

4. Add it to Claude
  • Claude.ai: Settings → Connectors → Add custom connector. URL https://<your-host>/mcp, choose No sign-in, then Add header Authorization = Bearer <MCP_AUTH_SECRET>.
  • Claude Code: claude mcp add --transport http moodle https://<your-host>/mcp --header "Authorization: Bearer <MCP_AUTH_SECRET>"
  • If a client can only be given a URL, use https://<your-host>/mcp/<MCP_AUTH_SECRET>. Treat that URL as a password; the header is preferred because URLs end up in logs.

Security and privacy

  • Your token acts as you: anyone who can call your endpoint can read what your token can read. Keep MOODLE_TOKEN and MCP_AUTH_SECRET in environment variables or Cloudflare secrets, never in the repo.
  • The server is read-only by design and has no write tools.
  • Whatever the tools return (grades, messages, names) is sent to Claude as part of your conversation. Check your institution's rules on sharing academic data with third-party services before using this, especially if you have access to other people's data (for example as a teacher).
  • See SECURITY.md to report a vulnerability.

Known limitations

  • Tested mainly against Moodle 4.5 with a student account. Teacher/admin roles and other versions or plugins are untested; reports and fixtures are welcome.
  • Sites can disable individual web service functions, so some tools may not work everywhere.
  • Large result sets are trimmed (for example, 25 assignments by default) to save context.

Development

npm ci
npm test            # unit tests with fixtures (no Moodle needed)
npm run typecheck
npm run dev         # HTTP server on :3000 (needs .env)
npm run dev:worker  # Cloudflare Worker locally (needs .dev.vars)

See CONTRIBUTING.md. Changes are listed in CHANGELOG.md.

License

MIT

الأسئلة الشائعة

ما هو Moodle MCP؟

Read-only Moodle server: assignments, deadlines, grades, courses, forums, notifications.

كيف أثبّت Moodle MCP؟

يعمل على جهازك. في Claude Code: claude mcp add moodle-mcp -e 'MCP_TRANSPORT=<MCP_TRANSPORT>' -e 'MOODLE_URL=<MOODLE_URL>' -e 'MOODLE_TOKEN=<your moodle_token>' -- npx -y @fabioov/moodle-mcp@0.1.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Moodle MCP إلى مفتاح API؟

نعم. يتطلب MOODLE_URL, MOODLE_TOKEN، وتضبطها في إعداداته.

هل Moodle MCP مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Moodle MCP؟

ينشره fabioov. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.