Skip to content

NTNU Courses (unofficial)

by MartinSA04 · remote · no sign-in to list tools · v0.4.0 · published by GitHub user MartinSA04

Unofficial NTNU course data: search, timetables, grades, course info, and exam logistics.

Changes · 1

12 tools: 1 change things and 11 only read.

Scanned Oct 21, 2026

No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http ntnu https://ntnu-mcp.martinsundal.no/mcp

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

12 tools

Changes things 1Claude Code: ask
  • check_timetable_conflictsChecks a set of NTNU courses for the same year for clashing lecture/lab times and colliding exam dates — a clash check to run before registering for courses.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Checks a set of NTNU courses for the same year for clashing lecture/lab times and colliding exam dates — a clash check to run before registering for courses. Accepts bare course codes. Each side of a conflict carries its activity 'kind': a lecture-vs-lecture clash is unavoidable, while one involving an exercise or lab often has alternative groups. Exam dates come from the catalog, which does not mark deferred (utsatt/kont) sittings.
Only reads 11Claude Code: allow
  • compare_coursesSide-by-side comparison of NTNU courses for a given year — campus, exam dates, weekly teaching hours, and latest grade distribution — to help choose between courses.No findings

    Why it is in this group

    • The name "compare_courses" says "compare": a word for reading.
    Description, as the server wrote it
    Side-by-side comparison of NTNU courses for a given year — campus, exam dates, weekly teaching hours, and latest grade distribution — to help choose between courses. Accepts bare course codes.
  • get_course_infoEverything about an NTNU course except exam logistics: credits, level, campus, language of instruction, prerequisites, mandatory activities, course content / learning outcomes, cre…No findings

    Why it is in this group

    • The name "get_course_info" says "get": a word for reading.
    Description, as the server wrote it
    Everything about an NTNU course except exam logistics: credits, level, campus, language of instruction, prerequisites, mandatory activities, course content / learning outcomes, credit reductions ('studiepoengreduksjon'), which study programs the teaching is planned for, contacts, and any alert notices (e.g. 'no longer taught'). English text by default; pass language 'nb' for Norwegian. Omit year for the current study year. For exam dates, times, aid codes, and rooms use get_exam_info.
  • get_course_scheduleEvery dated teaching activity (lectures, labs) for a course in a year, with Oslo-local times and rooms.No findings

    Why it is in this group

    • The name "get_course_schedule" says "get": a word for reading.
    Description, as the server wrote it
    Every dated teaching activity (lectures, labs) for a course in a year, with Oslo-local times and rooms. Long output for large courses — prefer get_weekly_timetable for a compact recurring-week overview.
  • get_course_versionsThe DBH-versioned course codes (like 'TDT4100-1') that exist for a bare NTNU course code.No findings

    Why it is in this group

    • The name "get_course_versions" says "get": a word for reading.
    Description, as the server wrote it
    The DBH-versioned course codes (like 'TDT4100-1') that exist for a bare NTNU course code. Useful when grade lookups come back empty.
  • get_exam_infoExam logistics for one or more NTNU courses in a single call: every exam occasion (ordinary / re-sit) with date, start time, duration, permitted-aids code ('hjelpemiddelkode') with…No findings

    Why it is in this group

    • The name "get_exam_info" says "get": a word for reading.
    Description, as the server wrote it
    Exam logistics for one or more NTNU courses in a single call: every exam occasion (ordinary / re-sit) with date, start time, duration, permitted-aids code ('hjelpemiddelkode') with its meaning, exam system, and assigned rooms. The way to answer 'when and where are my exams and what can I bring' for a whole semester at once. Rooms are only published days before the exam; unpublished fields are null. Omit year for the current study year.
  • get_grade_distributionHistorical grade distribution for an NTNU course (per year and semester, with counts and percentages; grades A-F, or pass/fail codes).No findings

    Why it is in this group

    • The name "get_grade_distribution" says "get": a word for reading.
    Description, as the server wrote it
    Historical grade distribution for an NTNU course (per year and semester, with counts and percentages; grades A-F, or pass/fail codes). Accepts bare codes like 'TDT4100'. Omit years to get all recorded years. Small counts may be privacy-masked. Data comes from Norway's official DBH statistics.
  • get_semestersNTNU's terms (semesters) with ids like '26h' (autumn 2026) / '26v' (spring), teaching weeks, exam-period dates, and which term is current.No findings

    Why it is in this group

    • The name "get_semesters" says "get": a word for reading.
    Description, as the server wrote it
    NTNU's terms (semesters) with ids like '26h' (autumn 2026) / '26v' (spring), teaching weeks, exam-period dates, and which term is current.
  • get_study_planThe official study plan for an NTNU program and cohort intake year: which courses (codes, credits, mandatory/elective) belong to each semester, and the specialization choice points…No findings

    Why it is in this group

    • The name "get_study_plan" says "get": a word for reading.
    Description, as the server wrote it
    The official study plan for an NTNU program and cohort intake year: which courses (codes, credits, mandatory/elective) belong to each semester, and the specialization choice points with their course groups. The bridge from 'I study X' to concrete course codes — feed them to get_weekly_timetable, check_timetable_conflicts, or get_exam_info. cohort_year is the year the student STARTED (defaults to the current cohort); students in their Nth year started N-1 years ago.
  • get_weekly_timetableThe recurring weekly timetable grid for a course in a year: weekday, times, ISO-week ranges, rooms, and a classified 'kind' per slot (lecture / exercise / lab / seminar / unknown).No findings

    Why it is in this group

    • The name "get_weekly_timetable" says "get": a word for reading.
    Description, as the server wrote it
    The recurring weekly timetable grid for a course in a year: weekday, times, ISO-week ranges, rooms, and a classified 'kind' per slot (lecture / exercise / lab / seminar / unknown). The compact way to answer 'when are the lectures for X' — filter on kind == 'lecture', since NTNU's own activity titles are free-form Norwegian text.
  • search_coursesSearch NTNU's course catalog for a given year (server-side free-text search over course names and codes; Norwegian terms often match best, e.g.No findings

    Why it is in this group

    • The name "search_courses" says "search": a word for reading.
    Description, as the server wrote it
    Search NTNU's course catalog for a given year (server-side free-text search over course names and codes; Norwegian terms often match best, e.g. 'maskinlæring' rather than 'machine learning'). Call this first when you don't know the exact course code. Returns course codes, Norwegian names, campus, and exam dates.
  • search_study_programsSearch NTNU's study-program catalog (~400 programs) by free text (name, code, keywords), study level (e.g.No findings

    Why it is in this group

    • The name "search_study_programs" says "search": a word for reading.
    Description, as the server wrote it
    Search NTNU's study-program catalog (~400 programs) by free text (name, code, keywords), study level (e.g. 'bachelor', 'master', 'ph.d'), and/or city (Trondheim, Gjøvik, Ålesund). Returns program codes like 'MTDT' — the input for get_study_plan. Call this first when you only know a program's name.

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 0.4.0. Values in angle brackets are yours to fill in.

claude mcp add --transport http ntnu https://ntnu-mcp.martinsundal.no/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__ntnu__search_courses",
      "mcp__ntnu__get_course_schedule",
      "mcp__ntnu__get_weekly_timetable",
      "mcp__ntnu__get_grade_distribution",
      "mcp__ntnu__get_course_versions",
      "mcp__ntnu__get_semesters",
      "mcp__ntnu__get_course_info",
      "mcp__ntnu__get_exam_info",
      "mcp__ntnu__search_study_programs",
      "mcp__ntnu__get_study_plan",
      "mcp__ntnu__compare_courses"
    ],
    "ask": [
      "mcp__ntnu__check_timetable_conflicts"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as ntnu. Review it before you use it.