Moodle MCP for Swiss universities

Use your university's Moodle from Claude: courses, materials, downloads, deadlines and announcements. Works with ZHAW, FHNW, ETH, EPFL and the other Swiss universities below, and with any other Moodle 4 site. You log in yourself (usually with SWITCH edu-ID) — your password is never seen or stored, and everything stays on your computer.

Unofficial student project, not affiliated with any university. Course material is for personal study only.

Formerly zhaw-moodle-mcp. Existing setups keep working: uvx zhaw-moodle-mcp now installs this package, and your login and settings stay where they are. For the Claude Desktop extension, install the new swiss-moodle-<version>.mcpb over the old one.

Quick start

Claude Desktop (recommended)

1. Download swiss-moodle-<version>.mcpb from the latest release.
2. Double-click it, or in Claude Desktop open Settings → Extensions → Advanced settings → Install Extension… and pick the file. Click Install.
3. Enter your university under University: its short name from the table below (e.g. fhnw) or the web address of your Moodle. You can also leave it empty and simply tell Claude in the chat which university you study at.
4. Open a new chat and ask "Which Moodle courses do I have?". The first start takes a few seconds; then a browser opens for the login.

To switch universities later, change University in the extension's settings (or, if you left it empty, ask Claude to switch). In the chat's + → prompts menu you find ready-made study sessions: study assistant, last lecture summary, deadlines overview, what's new, exam preparation.

Claude Code

Install uv, then (with your university's short name):

claude mcp add moodle -e MOODLE_MCP_INSTITUTION=fhnw -- uvx swiss-moodle-mcp@latest

Ask Claude

"Summarise the last lecture of Software Engineering 1", "Show all my deadlines as a table", "Sync all my courses", "What's new since Monday?". Files go to a folder named after your university in your home directory (e.g. ~/FHNW).

Universities

"Not tested yet": the site runs Moodle 4, but nobody has used this server there yet. It should work - you can help by running uvx swiss-moodle-mcp doctor, which tries every feature on one of your courses and prints a report without course names or personal data, and posting it as a compatibility report.

Not listed? Use the address of your Moodle instead of a short name (copy it from the browser while you are on your Moodle). The Moodle must be version 4.0 or newer; other learning platforms (ILIAS, OLAT, Canvas) are not supported.

Good to know

• Browser: login uses your default browser if it is Chrome, Edge, Brave or Vivaldi, otherwise another installed one (Firefox and Safari are not supported).
• Updates: the extension is updated by installing a newer .mcpb; with uvx ...@latest (Claude Code) updates install automatically when Claude starts.
• Extension does not start: it runs with uv. If Claude Desktop reports that uv is missing, install uv and restart Claude completely (also from the tray).
• Sync never deletes local files. Logging out (ask Claude, or uvx swiss-moodle-mcp logout) removes the stored session and the login browser profile; a running server notices it.
• Session and settings live in ~/.swiss-moodle-mcp on Windows (outside AppData, so Claude from the Microsoft Store and the command line share them) and in the usual app folders on macOS/Linux, with a separate instances/<moodle host> folder per Moodle site. Folders named zhaw-moodle-mcp from older versions keep being used.

Configuration

Choose your university once with uvx swiss-moodle-mcp setup (a list to pick from, or setup fhnw, or setup <address of your Moodle>); uvx swiss-moodle-mcp universities lists the known ones and uvx swiss-moodle-mcp status shows what is set. You can also just tell Claude your university ("I study at FHNW"); it stores the choice for you. If you used this server before v0.5, ZHAW stays selected.

The extension asks for the university, download folder and browser in its settings. Otherwise run uvx swiss-moodle-mcp config-path to see where config.toml goes:

[moodle]
institution = "zhaw"  # or bfh, epfl, ethz, ffhs, fhgr, fhnw, hes-so, hftm, ost, phlu, unifr,
                      # unige, unil, unine, usi, supsi - or the address of any other Moodle
# download_directory = "~/Studium/{short}"  # default ~/ZHAW, ~/FHNW, ...

[browser]
name = "auto"  # or "chrome", "msedge", "brave", "vivaldi"
# executable_path = "C:/path/to/browser.exe"  # any other Chromium-based browser

Development

uv sync
uv run pytest
uv run ruff check .

In this folder Claude Code picks up the server from .mcp.json, plus a study assistant subagent (copy it to ~/.claude/agents/ to use it everywhere). Build the Claude Desktop extension with uv run python scripts/build_extension.py (needs Node.js). Pushing a vX.Y.Z tag that matches pyproject.toml publishes to PyPI and attaches the .mcpb to a GitHub release.