# HSE RUZ

> HSE RUZ is an open-source MCP server for education and exams. HSE University timetable: find people, groups and rooms and get their schedules. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows
- **Repository:** https://github.com/ihavealotofguap/hse-ruz-mcp
- **MCP Registry name:** io.github.ihavealotofguap/hse-ruz-mcp
- **Categories:** [education and exams](https://ai-powered.com/categories/education-and-exams), [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [Zovo Org Chart Maker](https://ai-powered.com/mcp/zovo-org-chart-maker): Zovo Org Chart Maker is an MCP server for productivity.
- [Google Workspace MCP Server](https://ai-powered.com/mcp/google-workspace-mcp-server-2): Google Workspace MCP Server is an open-source MCP server for productivity.
- [InviteKit Calendar Files](https://ai-powered.com/mcp/invitekit-calendar-files): InviteKit Calendar Files is an MCP server for files and documents.
- [Penline Handwriting Sheets](https://ai-powered.com/mcp/penline-handwriting-sheets): Penline Handwriting Sheets is an MCP server for education and exams.
- [Google Workspace MCP](https://ai-powered.com/mcp/google-workspace-mcp-2): Google Workspace MCP is an MCP server for productivity.

---
Source: https://ai-powered.com/mcp/hse-ruz
