Log inSubmit server
İTÜ MCP logo

İTÜ MCP

Connects İTÜ Ninova, OBS, Portal, campus services, library, and public academic data to MCP clients.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install İTÜ MCP

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "i-t-mcp": {
      "command": "uvx",
      "args": [
        "itu-mcp"
      ],
      "env": {
        "NINOVA_USERNAME": "YOUR_VALUE_HERE",
        "NINOVA_PASSWORD": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 111 tools correctly (5d ago).

Overview

The İTÜ MCP MCP server connects MCP clients to İTÜ Ninova, OBS, Portal, campus services, library resources, İTÜ Mail, and public academic data. It exposes structured tools for course information, assignments, grades, attendance, schedules, cafeteria data, campus services, library searches, and selected account actions. Authenticated tools use local İTÜ credentials, while public tools work without credentials. Reach for it when an İTÜ student needs to query several university systems through one assistant.

Use cases

  • Check upcoming Ninova assignment deadlines
  • Retrieve OBS grades and attendance
  • Find public exam schedules and empty classrooms
  • Search the İTÜ library catalog
  • Read selected İTÜ Mail attachments

Key features

  • Ninova course and assignment tools
  • OBS grades, attendance, profile, and transcript access
  • Public schedules and campus service data
  • Library catalog and copy searches
  • Read-only İTÜ Mail tools
  • Optional confirmed assignment submission

Tools111

What İTÜ MCP lets your agent do. Expand a tool for its parameters.

Verified live~22.2k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

6/6 checks healthy over the last 45d

What it can do

From the 111 tools this server returned when we ran it; 111 declare their own safety hints.

Can delete or modify data · 3Handles credentials · 3Makes network requests · 111Read-only tools · 108
Network at startup2 connections
Files written at startup30

Observed 2026-10-18 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 6d ago via OSV.dev · itu-mcp (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars14Stargazers on the source repository.
Last commit7d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed111Callable tools this server registers over MCP.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How İTÜ MCP works

What İTÜ MCP MCP server does

The İTÜ MCP MCP server provides MCP tools for İTÜ student systems and public university information. It can read Ninova course data, assignments, deadlines, announcements, class files, and messages. Through OBS, it can retrieve registered courses, grades, attendance, profile details, advisor information, internship data, and transcript PDFs. Portal-related tools cover cafeteria menus, campus card information, and notifications.

The server also exposes data that does not require an authenticated session. These tools include public course and exam schedules, academic calendar information, campus locations, building codes, shuttle times, sports facility hours, announcements, and course archives. Library tools support catalog searches and checking copy availability. Read-only İTÜ Mail tools can list unread messages and support reading selected attachments through resource tools.

How it works

The server runs locally and communicates with each İTÜ service through a separate client. MCP-compatible applications call its tools and receive structured results that can be used to answer natural-language questions. Ninova and OBS authenticate through the İTÜ SSO flow, while public resources do not use account credentials.

Credentials remain on the local machine for the supported İTÜ authentication flows. Library account details, when needed, are kept separate from the Ninova password and are sent only to the official library service. The project states that it has no official affiliation with İTÜ and should be used with the user’s own account.

Some OBS endpoints can return inconsistent results between accounts. The server attempts to detect these cases and use a fallback source where available, but it does not guarantee complete accuracy. Important results should be checked against the corresponding OBS page.

Setup and configuration

Install the package with pipx install itu-mcp or pip install --user itu-mcp. A source installation is also supported with an editable install after cloning the repository. Copy the example environment file to .env, then set NINOVA_USERNAME to the İTÜ email address, usually in the form ad.soyad@itu.edu.tr, and set NINOVA_PASSWORD to the account password.

Before connecting an MCP client, use itu-mcp --version, itu-mcp --check-auth, itu-mcp --list-tools, and itu-mcp --list-prompts to check the installation and available functionality. Claude Code and Codex CLI can register the server with environment variables on the command line. Claude Desktop and Cursor configuration examples are provided in the repository documentation.

Tools and capabilities

Available tool groups include:

  • Ninova course listings, course resources, deadlines, synchronization, text extraction, and optional assignment submission.
  • OBS profile, registered courses, grades, attendance, advisor, transcript, notifications, GPA calculations, target-GPA calculations, and relative-grade estimates.
  • Public schedules, exam dates, academic calendar data, directory and location searches, announcements, shuttle schedules, and sports-facility hours.
  • Course conflict checks, open-section searches, empty-classroom searches, degree planning, and archived course information.
  • Library catalog and copy searches, plus read-only mail access and document-resource reading.

Assignment submission is an account-changing action and requires confirm=true. PDF and DOCX resources can be downloaded or read through read_resource_text for tasks such as summarization.

Limitations and notes

Authenticated features depend on access to the relevant İTÜ services and valid credentials. Public tools can be used without the .env credentials, but they do not provide private student records. The server is intended for the user’s own account and is not an official İTÜ integration. OBS data may be incomplete or vary by account, so the source system remains the final reference for uncertain grades, attendance, or other academic records.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about İTÜ MCP

İTÜ MCP is an MCP server that connects AI clients to İTÜ Ninova, OBS, Portal, campus services, library resources, and public university data. Its main tools retrieve courses, assignments, grades, attendance, schedules, cafeteria information, library records, and read-only mail content, with optional confirmed assignment submission.

Install it with `pipx install itu-mcp` or `pip install --user itu-mcp`. You can also clone the repository and run an editable install. Copy `.env.example` to `.env`, configure the İTÜ username and password, then run the version and authentication checks.

Yes, İTÜ MCP works with Cursor. The repository provides Cursor configuration guidance in its installation documentation and examples. After configuring the local server, restart the client and use the exposed MCP tools.

Public schedules, exam schedules, campus locations, shuttle information, sports facility hours, announcements, academic calendar data, and course archives work without credentials. Authenticated Ninova, OBS, Portal, and account-related features require the relevant session or account configuration.

Related MCP servers

All in Education All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewİTÜ MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/i-t-mcp?style=directory)](https://allmcps.com/mcp/i-t-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/i-t-mcp"><img src="https://allmcps.com/api/badge/i-t-mcp?style=directory" alt="İTÜ MCP on AllMCPs" /></a>