HSE RUZ
HSE University timetable: find people, groups and rooms and get their schedules
- 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-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"hse-ruz-mcp": {
"command": "npx",
"args": [
"-y",
"hse-ruz-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"hse-ruz-mcp": {
"command": "npx",
"args": [
"-y",
"hse-ruz-mcp"
]
}
}
}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.
