Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add --env LIBRUS_USERNAME=<LIBRUS_USERNAME> --env LIBRUS_PASSWORD=<LIBRUS_PASSWORD> --env LIBRUS_ALIAS=<LIBRUS_ALIAS> --transport stdio librus-synergia -- uvx librus-mcp
Open on GitHub

What 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-mcp

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>

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.

Similar MCP servers

All MCP servers for Notes, tasks and projects →

Project sponsors

Companies that keep this analytics open