
spbstu-mcp
MCP server for SPbPU (Polytech) students: dl.spbstu.ru Moodle, university mail and openedu.ru for Claude
Install with your AI
Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.
Install and set up spbstu-mcp (release-binary project) into my current project. Found on https://claudeers.com/spbstu-mcp Repo: https://github.com/kad-xyz/spbstu-mcp Homepage/docs: — Detected install method: release-binary → inspect the README Category: mcp-servers. Platforms: api, desktop, web, mobile. Read the repo's README for exact setup and env vars, then install it and wire it into my project. Claudeers Health Verdict: active; community-verified: false. Confirm the source before running anything.
Grab the latest release asset from GitHub.
# download a build from https://github.com/kad-xyz/spbstu-mcp/releases
git clone https://github.com/kad-xyz/spbstu-mcp
// compatibility
| Platforms | api, desktop, web, mobile |
|---|---|
| Operating systems | — |
| AI compatibility | claude |
| License | MIT |
| Pricing | open-source |
| Language | Go |
spbstu-mcp
Your Peter the Great St. Petersburg Polytechnic University (SPbPU) studies, available to Claude.
An MCP server for SPbPU student services: the dl.spbstu.ru Moodle, the university mailbox, openedu.ru and the timetable. You sign in with your university account; your password stays in your operating system's credential store.
English · Русский
https://github.com/user-attachments/assets/79137c69-5d3f-4270-9164-e509f88c3535
"What's due this week?" · "Summarise the database course assignment and download its files." · "Did the teacher grade my coursework?" · "Draft a reply to the curator's email."
Contents
- What it does
- Quick start
- Tools
- How it works
- Security and privacy
- Configuration
- Troubleshooting
- Development
- Contributing
What it does
| Service | Read | Write | |
|---|---|---|---|
| 🎓 | dl.spbstu.ru, the Moodle LMS | courses, course contents, assignments with full task text, deadlines, submission status and feedback, grades, forums, pages, files | submit work to an assignment, post to forums with attachments |
| ✉️ | mail.spbstu.ru, Exchange | list and search mail, read messages, save attachments | write new messages and replies (saved as drafts by default), delete |
| 📚 | openedu.ru, Open edX | enrolled courses, progress and grades, due dates, course outline | |
| 🗓 | ruz.spbstu.ru, the public timetable | weekly timetable of any group or teacher | |
| 🧭 | Everything at once | study_overview: dl deadlines, openedu.ru progress and unread mail in one call | |
| 🏛 | my.spbstu.ru, «Мой Политех» | record book grades with semester averages, study plan, this year's work plan |
Quick start
1. Store your university login in the operating system's credential store. LOGIN is your single university
account, the one in [email protected].
macOS: keychain
security add-generic-password -s spbstu -a [email protected] -T /usr/bin/security -w
[!IMPORTANT] Keep
-wlast, so thatsecurityprompts for the password with hidden input; anything after-wwould be stored as the password itself. To check (prints only the length):security find-generic-password -s spbstu -w | wc -c
Linux: Secret Service (GNOME Keyring, KWallet)
Needs secret-tool (apt install libsecret-tools, dnf install libsecret, pacman -S libsecret):
secret-tool store --label=spbstu service spbstu account [email protected]
Windows: Credential Manager
cmdkey /generic:spbstu /user:[email protected] /pass
The password is asked with hidden input in every case.
2. Install the server. With Homebrew (macOS, Linux):
brew install kad-xyz/tap/spbstu-mcp
Or download the archive for your system from Releases
and put spbstu-mcp somewhere on disk, e.g. ~/.local/bin. On macOS, clear the download quarantine (the binary is not
notarized):
xattr -d com.apple.quarantine ~/.local/bin/spbstu-mcp
Or build from source (Go 1.26+)
go install github.com/kad-xyz/spbstu-mcp/cmd/spbstu-mcp@latest
3. Connect it to Claude.
| Claude Code | Claude Desktop |
|---|---|
|
|
Then just ask: "What's going on with my studies?"
[!TIP] No account at hand? Start the server with
-demo(claude mcp add spbstu-demo -- spbstu-mcp -demo): it serves a made-up student's courses, deadlines and mail, touches no university service and needs no credentials.
Tools
Across services: 3 tools
| Tool | Description |
|---|---|
study_overview | dl.spbstu.ru deadlines (with recently overdue ones), progress in current openedu.ru courses and unread mail. A source that fails is reported, the rest still come back. |
study_subject | Everything about one discipline: work-plan hours and control type, the dl course with assignments, quizzes, deadlines and teachers, grades received. |
study_export_ics | Every upcoming dl and openedu due date as an .ics file with day-before reminders, for Apple, Google or Outlook Calendar. |
dl.spbstu.ru: 20 tools
| Tool | Description |
|---|---|
dl_courses | Courses you are enrolled in (current ones, or all). |
dl_course_contents | Sections of a course with their activities, descriptions and file links. |
dl_deadlines | Upcoming and recently overdue due dates across all courses. |
dl_assignments | Assignments of a course: full task text, due dates, attached files. |
dl_submission_status | Your submission for an assignment: status, files, grade, teacher feedback. |
dl_grades | Your grades in a course. |
dl_forum_discussions | Discussions of a forum. |
dl_discussion_posts | All posts of a discussion, with attachments. |
dl_page | Text of a page resource (exam rules, ticket lists). |
dl_download | Download a file to ~/Downloads/spbstu. |
dl_quizzes | Quizzes of a course: opening and closing time, time limit, attempts allowed and used, best grade (information only). |
dl_teachers | Teachers of a course and their last visit. |
dl_notifications | Newest notifications: grades, feedback, forum posts, due dates. |
dl_messages | Private conversations with their last message. |
dl_conversation | All messages of a conversation. |
dl_search | Search every course for activities, resources and files. |
dl_send_message ✍️ | Send a private message, e.g. to a teacher. |
dl_submit_assignment ✍️ | Upload files and/or text to an assignment, optionally submit for grading. |
dl_forum_new_discussion ✍️ | Start a discussion, e.g. post a report to an upload forum. |
dl_forum_reply ✍️ | Reply to a post. |
Mail: 9 tools
| Tool | Description |
|---|---|
mail_list | Newest messages of a folder; unread only; search (from:name, subject:word, plain words). |
mail_read | A whole message as plain text, with recipients and attachments. |
mail_download_attachment | Save an attachment to ~/Downloads/spbstu/mail. |
mail_send ✍️ | New message or reply. Saves a draft unless send is true. |
mail_delete ✍️ | Move a message or draft to Deleted Items (restorable). |
mail_folders | Mail folders with total and unread counts. |
mail_move | Move messages to another folder. |
mail_mark | Mark messages read or unread. |
mail_calendar | Events of the mailbox calendar: meetings, webinars, consultations. |
my.spbstu.ru: 5 tools
| Tool | Description |
|---|---|
my_grades | Record book (зачётка): every grade with control type, date and lecturer; average of each semester. |
my_study_plan | The programme's study plan: disciplines, semesters, hours, control type. |
my_work_plan | This year's work plan by semester: lecture, practice, lab and self-study hours. |
my_record_books | Record books, one per programme, with the group. |
my_debts | Academic debts: disciplines whose latest grade is failing, and past ones with no grade to check. |
Timetable: 1 tool
| Tool | Description |
|---|---|
schedule | Week of a group or a teacher: time, type, teachers, room, webinar and dl links. Ambiguous names return the candidates. |
openedu.ru: 4 tools
| Tool | Description |
|---|---|
openedu_courses | Your enrolled courses. |
openedu_progress | Completed units, current grade, grading policy, score of every subsection. |
openedu_dates | Course start, end and due dates. |
openedu_outline | Chapters and subsections with completion and links. |
✍️ changes something on a university service; see Security and privacy.
How it works
flowchart LR
C[Claude] -- MCP / stdio --> S[spbstu-mcp]
K[(OS credential store<br/>item "spbstu")] -. login + password .-> S
S -- SSO --> CAS[cas.spbstu.ru]
CAS --> DL[dl.spbstu.ru<br/>Moodle mobile API]
S -- SSO --> KC[sso.openedu.ru<br/>«Политех» provider] --> CAS
KC --> OE[courses.openedu.ru<br/>Open edX API]
S -- EWS, Basic auth over TLS --> M[mail.spbstu.ru<br/>Exchange]
S <-. sessions .-> ST[(~/.config/spbstu-mcp<br/>state.json, 0600)]
- dl.spbstu.ru: signs in through the university SSO and obtains a Moodle mobile web service token, the same way the official Moodle app does.
- openedu.ru: signs in through the «Политех» identity provider of the openedu.ru SSO, then reads the Open edX course APIs.
- Mail: Exchange Web Services with the same account.
- my.spbstu.ru: its own sign-in form, then the JSON endpoints its pages use.
- Sessions (the Moodle token and cookies) are kept between runs, so the server signs in again only when a session has expired. University sites lock accounts after frequent sign-ins.
Security and privacy
- 🔑 The password never leaves your Mac except to SPbPU and openedu.ru sign-in pages. It is read from the credential store at sign-in time and never appears in tool results.
- 🗂 Sessions are stored in
~/.config/spbstu-mcp/state.json, readable only by you. Delete the file to sign out everywhere. - ✋ Writes need your confirmation. The descriptions of
dl_submit_assignment,dl_forum_*andmail_sendtell the model to act only after you have confirmed exactly what goes where.mail_sendonly saves a draft unless asked to send. - 🚫 No exams. The server cannot take graded tests or proctored exams, and is not meant to.
[!WARNING] This is an unofficial project, not affiliated with SPbPU or openedu.ru. Use it with your own account only.
Configuration
| Flag | Default | Description |
|---|---|---|
-keychain-service | spbstu | Name of the credential store item with the university login. |
-downloads | ~/Downloads/spbstu | Where downloaded files and attachments are saved. |
-group | Default group for schedule, e.g. 5130902/30201. | |
-demo | false | Serve made-up data instead of the university services; no credentials needed. |
Troubleshooting
| Symptom | Fix |
|---|---|
keychain item "spbstu" not found (or Secret Service item, credential) | Create it, see Quick start. |
CAS rejected the credentials | Check the stored password length; re-create the item with -w last. |
mail.spbstu.ru rejected the credentials | The keychain account must be the full address, [email protected]. |
| Sign-in keeps failing after many attempts | The site may have locked sign-ins for a while. Wait, then try once. |
| macOS: "cannot be opened because the developer cannot be verified" | xattr -d com.apple.quarantine ~/.local/bin/spbstu-mcp |
Development
go test ./... # offline unit tests
SPBSTU_LIVE=1 go test ./... # plus checks against the live services (needs the credential item)
go build -o bin/spbstu-mcp ./cmd/spbstu-mcp
cmd/spbstu-mcp MCP tools (dl, mail, openedu, overview)
internal/cas university SSO sign-in
internal/moodle dl.spbstu.ru client
internal/ews Exchange Web Services client
internal/openedu openedu.ru and Open edX client
internal/mypoly my.spbstu.ru client
internal/ruz public timetable client
internal/keychain credential stores: macOS keychain, Secret Service, Windows Credential Manager
internal/state persisted sessions and cookie jar
Releases are built by GitHub Actions on every v* tag.
Contributing
Contributions are welcome, in English or Russian: read CONTRIBUTING.md first. Security issues go through private advisories, not public issues.
License
// faq
What is spbstu-mcp?
MCP server for SPbPU (Polytech) students: dl.spbstu.ru Moodle, university mail and openedu.ru for Claude. It is open-source on GitHub.
Is spbstu-mcp free to use?
spbstu-mcp is open-source under the MIT license, so it is free to use.
What category does spbstu-mcp belong to?
spbstu-mcp is listed under mcp-servers in the Claudeers registry of Claude-compatible tools.
// embed badge
[](https://claudeers.com/spbstu-mcp)
// retro hit counter
[](https://claudeers.com/spbstu-mcp)
// reviews
// guestbook
// related in MCP Servers
f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete…
A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
🪨 why use many token when few token do trick — Claude Code skill that cuts 65% of tokens by talking like caveman
An open-source AI agent that brings the power of Gemini directly into your terminal.