Skip to content
MCP server

HSE RUZ

HSE University timetable: find people, groups and rooms and get their schedules

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS, Linux
Runs
Locally
Version
0.2.3
Listing updated
today

Similar MCP servers

About HSE RUZ

HSE RUZ is an open-source MCP server for education and exams. It runs locally on your machine and is started by your AI client.

Students and staff at the Higher School of Economics can ask an assistant about classes without opening the timetable site. The server looks up a student, lecturer, group or room by name and returns its lessons for a date range, or finds a student's own schedule by their @edu.hse.ru email.

It talks to the university's RUZ API, which only answers from inside the HSE network, such as campus Wi-Fi or the staff VPN. From outside, the API returns an HTML placeholder and the tools respond with an explanatory error. No login, password or browser is needed.

Schedules can span up to 60 days starting from any date, with subject and room names in Russian or English. Dates use Moscow time, requests time out after 15 seconds, and successful answers are cached in memory for five minutes. All tools are marked read-only. It needs Node.js 22 or later and is MIT licensed.

Install

Run in a terminal

claude mcp add hse-ruz-mcp -- npx -y hse-ruz-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "hse-ruz-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "hse-ruz-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "hse-ruz-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "hse-ruz-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "hse-ruz-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "hse-ruz-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "hse-ruz-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "hse-ruz-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "hse-ruz-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "hse-ruz-mcp"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

ruz_find_person
Searches students, lecturers, groups or rooms by substring.
ruz_get_schedule
Returns a schedule by RUZ id and type.
ruz_get_my_schedule
Returns a student's schedule by corporate email.

What it does

Name search
Finds students, lecturers, groups or rooms from a substring of two characters or more.
Schedule lookup
Returns lessons for a person, group or room by RUZ id.
Own schedule by email
Looks up a student's timetable from their corporate email.
Period control
Choose a start date and 1 to 60 days ahead.
Russian or English
Subject and room names can be returned in either language.
Read-only
Tools only read data and declare a read-only hint.

Good for

  • Ask what classes are tomorrow using a student email
  • Show a group's timetable for the coming week
  • Check a lecturer's classes for next week
  • Find which rooms a course uses

Pricing

Open source

MIT licensed; free.

HSE RUZ FAQ

Why does it fail from home?

RUZ only answers inside the HSE network, so use campus Wi-Fi or the staff VPN.

Do I need to log in?

No login, password or browser is needed.

What does it need to run?

Node.js 22 or later; install with npx -y hse-ruz-mcp.

How fresh are results?

Successful responses are cached in memory for five minutes.

Is HSE RUZ free?

Yes. HSE RUZ is open source, so you can use and self-host it for free.

How do I add HSE RUZ to Claude Code?

Run this command in your terminal: claude mcp add hse-ruz-mcp -- npx -y hse-ruz-mcp

What are the best alternatives to HSE RUZ?

The closest alternatives to HSE RUZ are Ha MCP, Concord MCP, note1, Zovo Org Chart Maker and Google Workspace MCP Server.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers