ufind-mcp

An MCP server for u:find, the course catalogue of the University of Vienna. Ask your assistant what a department offers this semester, when a course meets, who teaches it, or where a room is. Read only, no account, no API key.

Install

git clone https://github.com/ParadoxTR/ufind-mcp.git
cd ufind-mcp
uv sync

Add it to Claude Code:

claude mcp add ufind --scope user -- uv --directory /absolute/path/to/ufind-mcp run ufind-mcp

Or add it to Claude Desktop, Cursor or any other MCP client:

{
  "mcpServers": {
    "ufind": {
      "command": "uv",
      "args": ["--directory", "/absolute/path/to/ufind-mcp", "run", "ufind-mcp"]
    }
  }
}

What you can ask

Which courses does the Bachelor Informatik programme offer in 2026W?

When and where does 180013 meet, and who teaches it?

Find logic courses next semester with fewer than 3 ECTS.

What is Benjamin Schnieder teaching this winter?

Give me the module structure of the Master Philosophie curriculum.

Tools

Semesters are written 2026W (winter 2026/27) or 2027S. Every tool also accepts current, next and previous.

Configuration

Good to know

u:find has no public API. This server reads the XML endpoints that the mobile clients use and, for the parts those endpoints do not cover, the public web pages. That means the university can change things without notice. Requests go out one at a time with a small pause, and every response is cached on disk, so normal use stays light on their servers.

A semester that has not started yet is incomplete. Course descriptions, registration windows and exam dates often stay empty until the term begins.

Catalogue paths are specific to one semester, so a programme has a different id in 2026W than in 2026S. The server resolves programmes by name for the semester you ask about and warns you if a path belongs to a different term.

A course that counts towards several modules appears once per module in a programme listing. Output always states how many entries and how many distinct courses that is.

Tests

uv run python tests/smoke.py      # live data, parsing and completeness
uv run python tests/mcp_smoke.py  # calls every tool over the MCP protocol

Disclaimer

This project is not affiliated with, endorsed by or supported by the University of Vienna. It reads endpoints that are not part of a documented public API, so it can break at any time. Use it for your own studies and keep the default rate limiting in place. If you need guaranteed access, ask the university.

License

MIT