Moodle Downloader

Download courses from any Moodle site for offline study — CLI + MCP server for AI agents.

Personal use only. Don’t redistribute materials you download.

License: MIT Python 3.11+

Agents: README.agents.md · paste-ready prompt below.

Give this to your AI agent

Copy into Grok / Claude / Cursor / Codex (fill the blanks):

Install and set up Moodle Downloader MCP from:
https://github.com/stojandev/moodle-downloader-mcp

1. Clone the repo (or use my existing checkout), create a venv, pip install -e .
2. Read README.agents.md and follow it (always use --json; never print passwords/tokens).
3. Ask me only for:
   - Moodle base URL (e.g. https://moodle.my-school.edu)
   - Username (exactly as on the portal — don’t invent the format)
   - Password (or webservice token if I have one)
4. Run: moodle-agent probe --url <URL> --json
5. Then: init with MOODLE_URL / MOODLE_USER / MOODLE_PASS (or --token) --out ./courses --force --json
6. Verify: moodle-agent whoami --json
7. Sync all courses: moodle-agent sync --out ./courses --json
8. Optionally register MCP: moodle-agent-mcp from the venv (see README).

My Moodle URL: _______________
My username: _______________

Install

Requires: Python 3.11+

git clone https://github.com/stojandev/moodle-downloader-mcp.git
cd moodle-downloader-mcp

python3 -m venv .venv
source .venv/bin/activate
pip install -e .

python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -e .

Check:

moodle-agent version

Quick start

moodle-agent setup
moodle-agent init --url "https://moodle.example.edu" -u YOUR_USER
moodle-agent courses list
moodle-agent sync --out ./courses

• Any school — pass your Moodle URL; username is whatever you use on the portal.
• Password is prompted and not stored (only a token).
• Config: ~/.config/moodle-agent/ · Windows %APPDATA%\moodle-agent\

MCP (optional)

Point your client at the binary from the venv:

# e.g. ~/.grok/config.toml
[mcp_servers.moodle-agent]
command = "/full/path/to/.venv/bin/moodle-agent-mcp"   # Windows: ...\.venv\Scripts\moodle-agent-mcp.exe
enabled = true
tool_timeout_sec = 3600

Docs

Limits (v0.1): no forums/quizzes; course-level download only; Python 3.11+.

License

MIT · © 2026 Aleksa Stojanović