Librus Synergia — Claude Code MCP server: what it does and setup
Connects your assistant to the Librus Synergia school gradebook. Lets you check grades, attendance, homework, and timetables directly in chat.
MIT ★ 15 updated 2026-10-28
claude mcp add --env LIBRUS_USERNAME=<LIBRUS_USERNAME> --env LIBRUS_PASSWORD=<LIBRUS_PASSWORD> --env LIBRUS_ALIAS=<LIBRUS_ALIAS> --transport stdio librus-synergia -- uvx librus-mcpWhat Librus Synergia does
The server gives AI assistants access to the Librus Synergia school register via librus-python-api. It exposes student records, current marks, class timetables, attendance history, homework tasks, and official school announcements.
Local setup runs through uvx without manual repository cloning. Credentials can pass via environment variables for a single user or through a private config.json file for families with multiple student profiles. Each profile gets its own alias in queries.
Accounts that require interactive two-factor authentication will not work. In addition, sending outgoing messages is disabled by default in the configuration.
What it helps with
- Check current grades and academic history for students
- Inspect class timetables and school-free days
- Review homework assignments and school announcements
- Track attendance records across terms
Example prompts for the agent
- Show me the latest grades in math from Librus
- What does the class schedule look like for tomorrow?
- Check pending homework for the daughter alias
How to install Librus Synergia
Platform CLI
claude mcp add --env LIBRUS_USERNAME=<LIBRUS_USERNAME> --env LIBRUS_PASSWORD=<LIBRUS_PASSWORD> --env LIBRUS_ALIAS=<LIBRUS_ALIAS> --transport stdio librus-synergia -- uvx librus-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from librus-mcp <command>
Platform CLI
codex mcp add librus-synergia --env LIBRUS_USERNAME=<LIBRUS_USERNAME> --env LIBRUS_PASSWORD=<LIBRUS_PASSWORD> --env LIBRUS_ALIAS=<LIBRUS_ALIAS> -- uvx librus-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from librus-mcp <command>
Config file
{
"mcpServers": {
"librus-synergia": {
"command": "uvx",
"args": [
"librus-mcp"
],
"env": {
"LIBRUS_USERNAME": "<LIBRUS_USERNAME>",
"LIBRUS_PASSWORD": "<LIBRUS_PASSWORD>",
"LIBRUS_ALIAS": "<LIBRUS_ALIAS>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from librus-mcp <command>
Config file
{
"servers": {
"librus-synergia": {
"type": "stdio",
"command": "uvx",
"args": [
"librus-mcp"
],
"env": {
"LIBRUS_USERNAME": "<LIBRUS_USERNAME>",
"LIBRUS_PASSWORD": "<LIBRUS_PASSWORD>",
"LIBRUS_ALIAS": "<LIBRUS_ALIAS>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from librus-mcp <command>
Platform CLI
gemini mcp add -e LIBRUS_USERNAME=<LIBRUS_USERNAME> -e LIBRUS_PASSWORD=<LIBRUS_PASSWORD> -e LIBRUS_ALIAS=<LIBRUS_ALIAS> librus-synergia uvx librus-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from librus-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Librus Synergia
How do I install Librus Synergia in Claude Code?
Run this command: claude mcp add librus-mcp -e LIBRUS_USERNAME=<LIBRUS_USERNAME> -e LIBRUS_PASSWORD=<LIBRUS_PASSWORD> -- uvx librus-mcp. Replace placeholders with your actual credentials.
What does the Librus Synergia server do?
It connects your assistant to the Librus school platform. The model can inspect lesson schedules, homework tasks, attendance, and grade summaries.
Does this server support two-factor authentication?
No, accounts requiring interactive two-factor authentication are not supported. You need a standard login and password combination.