ninova-mcp 0.1.5

Credential-based MCP server for ITU Ninova: read courses, announcements, files, assignments, grades, attendance, and deadlines from Claude, Cursor, Codex, and other MCP clients.

Ninova MCP

Connect your İTÜ Ninova account to AI assistants like Claude. Ask about your courses, announcements, assignments, grades, files, attendance, and upcoming deadlines in plain language — the assistant reads Ninova for you.

It logs in with your own İTÜ username and password, opens its own temporary Ninova session, and never touches your browser or sends your password anywhere except ninova.itu.edu.tr.

What you can ask

• "Bu hafta hangi ödevlerimin teslimi var?"
• "X dersinde yeni duyuru veya ders dosyası var mı?"
• "Notlarımı ve ağırlıklı ortalamamı göster."
• "Tüm derslerimdeki son değişiklikleri özetle."

Install — pick one

1. Easiest: Claude Desktop, one click (no Python, no terminal)

1. Download your platform's file from the latest release:
   • macOS (Apple Silicon / M1–M4): ninova-mcp-*-darwin-arm64.mcpb
   • Windows: ninova-mcp-*-windows-amd64.mcpb
2. Double-click the file. Claude Desktop opens an install dialog.
3. Enter your İTÜ username and password, click Install. Done.

The bundle ships its own Python runtime, so there is nothing else to install. Your password is stored in your operating system's secure keychain.

2. Let your AI set it up (Claude Code, Cursor, Codex, and others)

Paste this to your AI assistant — it installs the server and configures your client end-to-end:

Install the ninova-mcp MCP server (PyPI: ninova-mcp, https://github.com/hikmedit/ninova-mcp).
1. Install it: `pipx install ninova-mcp` (or `pip install --user ninova-mcp`) — both put a
   `ninova-mcp` command on my PATH.
2. Register a `ninova` MCP server (command `ninova-mcp`, env NINOVA_USERNAME and
   NINOVA_PASSWORD) in whichever MCP client I use — detect it and edit the right config,
   merging into any existing servers without overwriting them. Leave the credentials as
   placeholders unless I already pasted them here.
3. Tell me to fill in my İTÜ credentials, restart the client, and call the `auth_status`
   tool to verify.

3. One command (if you prefer the terminal)

After pipx install ninova-mcp:

# Claude Code
claude mcp add ninova ninova-mcp -e NINOVA_USERNAME=itu_username -e NINOVA_PASSWORD=itu_password

# Codex CLI
codex mcp add ninova --env NINOVA_USERNAME=itu_username --env NINOVA_PASSWORD=itu_password -- ninova-mcp

Other clients (Claude Desktop config file, Cursor, manual TOML) are in the installation guide.

To confirm it works, ask the assistant to run the auth_status tool.

Is it safe?

Yes — it runs entirely on your machine. Your İTÜ password stays local (in your OS keychain when installed as the extension) and is only ever sent to ninova.itu.edu.tr. Nothing is uploaded to any third-party server, and it never reads your browser cookies. Details: docs/security.md.

What it can do

Reads your dashboard and course list, announcements, class and lesson files, assignments (with detail pages and deadlines), grades, message boards, attendance, and remote-learning sessions — plus a combined per-course overview. It can also sync all courses, track what changed since last time, and list upcoming deadlines.

Full tool reference and self-hosting (remote HTTP server for ChatGPT / Claude.ai connectors, Docker, environment variables, running from source): docs/advanced.md.

License

MIT. Not affiliated with İTÜ; use with your own account.