Skip to main content
Glama

DTU Learn MCP (unofficial)

Let your AI assistant see your DTU Learn courses: lecture slides, course material, assignments, deadlines and announcements. Ask things like:

"What do I need to prepare for Thursday's 02450 lecture?" "Summarize the week 6 slides in Linear Algebra." "What's due in the next two weeks, and what does Project 2 actually ask for?"

It works with Claude Code, Claude Desktop, Codex (CLI and IDE), Cursor and other apps that support local MCP servers.

Unofficial. This is a student project, not made or endorsed by DTU. It only reads what your own DTU Learn account can already see.

How it works

  • Runs on your own computer. Your AI app starts it in the background when needed. There is no server in between.

  • You sign in yourself. login opens a normal browser window with DTU's own sign-in page. Your password and MFA never pass through this tool. Only the resulting DTU Learn session is saved, in ~/.dtu-learn-mcp/, readable only by you. (The one exception is automatic sign-in, which you have to turn on yourself.)

  • Read-only. It only ever reads from DTU Learn. It cannot submit assignments, post, or change anything. Every tool is marked read-only.

  • Files stay local. Files you ask about are downloaded to ~/.dtu-learn-mcp/files/ so the assistant can read them.

See PRIVACY.md for details.

Related MCP server: ufora-mcp

Setup (about 2 minutes)

You need Node.js 20 or newer, Git, and Google Chrome or Microsoft Edge. The tool is not on npm: npx runs it straight from this GitHub repo.

1. Sign in once:

npx -y github:frederikngh/dtu-learn-mcp login

A browser window opens. Sign in to DTU Learn as usual (including MFA). When the DTU Learn front page appears, the window closes and you're done.

2. Add it to your AI app:

claude mcp add dtu-learn --scope user -- npx -y github:frederikngh/dtu-learn-mcp

Or install the plugin, which also adds the /dtu-learn:prepare-for-lecture and /dtu-learn:week-plan skills:

claude plugin marketplace add frederikngh/dtu-learn-mcp
claude plugin install dtu-learn@dtu-learn

Settings → Developer → Edit Config, and add to claude_desktop_config.json:

{
  "mcpServers": {
    "dtu-learn": { "command": "npx", "args": ["-y", "github:frederikngh/dtu-learn-mcp"] }
  }
}

Restart Claude Desktop.

codex mcp add dtu-learn -- npx -y github:frederikngh/dtu-learn-mcp

Add a local (stdio) MCP server with command npx and arguments -y github:frederikngh/dtu-learn-mcp.

The ChatGPT desktop app may be able to use local MCP servers depending on your version and plan; check OpenAI's current docs. chatgpt.com in the browser cannot reach a server on your computer.

Windows: if npx isn't found by your app, use "command": "cmd", "args": ["/c", "npx", "-y", "github:frederikngh/dtu-learn-mcp"].

Browser and phone apps (claude.ai, chatgpt.com, mobile) are not supported: they run in the cloud and can't reach a server on your computer.

Automatic sign-in (optional, macOS)

DTU Learn sessions run out after a while, and DTU's sign-in has no "keep me signed in" option, so now and then the tool asks you to sign in again. If your DTU login has no MFA step, you can let the tool sign in by itself instead:

npx -y github:frederikngh/dtu-learn-mcp login --save-password

It asks for your DTU username and password in the terminal, checks them on DTU's own sign-in page, and saves them in your macOS Keychain (not in a file). From then on, when the session runs out, the hidden browser fills in DTU's sign-in page for you.

  • The password is only ever typed into DTU's own sign-in page (sts.ait.dtu.dk), at most once a minute.

  • If a sign-in with the saved password doesn't succeed (for example after you change your password, or if DTU adds an MFA step), the tool deletes it immediately instead of retrying, so it can't get your account locked. Run the command again to save the new one.

  • npx -y github:frederikngh/dtu-learn-mcp forget-password turns it off again; logout also removes it.

  • status shows whether automatic sign-in is on.

This is a trade-off: anything that can run commands as your macOS user can read the saved password from the Keychain. Leave it off if that isn't OK for you.

Tools

Tool

What it does

list_courses

Your current (or past) courses

get_course_outline

A course's modules and files, searchable ("lecture 5", "week 6"), with the text on a found module's page (the week's reading, exercises, hand-in)

read_file

Downloads a file and returns its text: PDF, PowerPoint (with speaker notes), Word, notebooks, code. Also takes a DTU Learn link to a file, e.g. from a module page

get_topic

Details and URL for links, videos (Panopto) and external tools

get_upcoming

Deadlines and dated items in the next N days

list_assignments / get_assignment

Hand-ins with instructions, attachments, your submission status and feedback (your handed-in files and feedback files can be read with read_file)

get_announcements

Recent course announcements

status / login

Check or renew your sign-in

Courses can be named by number (02450) or by part of their name.

Command line

Everything is also available from a terminal, which works with any agent that can run commands:

npx -y github:frederikngh/dtu-learn-mcp courses
npx -y github:frederikngh/dtu-learn-mcp upcoming --days 14
npx -y github:frederikngh/dtu-learn-mcp outline 02450 --search "lecture 5"
npx -y github:frederikngh/dtu-learn-mcp file 02450 123456
npx -y github:frederikngh/dtu-learn-mcp --help

Troubleshooting

  • "Not signed in" / "session has expired": run npx -y github:frederikngh/dtu-learn-mcp login again. The tool tries a silent renewal first, so this should be rare. To stop it happening at all, see automatic sign-in.

  • "DTU rejected the saved password": you probably changed your DTU password. The old one was removed so it can't lock your account; run login --save-password again.

  • "Could not start a browser": install Chrome or Edge, or run npx playwright install chromium.

  • "spawn git ENOENT" or similar: install Git; npx needs it to fetch the tool from GitHub.

  • Check everything: npx -y github:frederikngh/dtu-learn-mcp status.

  • Remove all saved data: npx -y github:frederikngh/dtu-learn-mcp logout --all, then delete ~/.dtu-learn-mcp.

Settings (environment variables): DTU_LEARN_DOWNLOAD_DIR (where files go), DTU_LEARN_BROWSER (chrome, msedge, …), DTU_LEARN_URL (another Brightspace site; untested).

Known limitations

  • Lecture and group-work times come from DTU's timetable, which DTU copies into the DTU Learn calendar; get_upcoming shows them when they are there.

  • Videos, Panopto, FeedbackFruits and other external tools can't be read, only linked.

  • Scanned PDFs have no text to extract; the file is still saved so a vision-capable assistant can open it.

Development

npm install
npm test        # builds, then runs the tests against a fake Brightspace server
npm run dev     # recompile on change

Test your local build in Claude Code with claude mcp add dtu-learn-dev -- node /path/to/dtu-learn-mcp/dist/cli.js.

Code layout: src/auth.ts (browser sign-in), src/client.ts (read-only API client), src/api.ts (courses, content, assignments…), src/tools.ts (tool definitions, shared by MCP and CLI), src/mcp.ts (MCP over stdio), src/extract.ts (file text). The plugin (skills + MCP config) lives in plugin/.

Contributions welcome. Please keep it read-only.

License

MIT

Available Tools

10 tools
get_announcementsRecent announcementsB
Read-onlyIdempotent

Shows recent announcements (news) from all courses, newest first.

Inputs: days, course.

get_assignmentAssignment detailsA
Read-onlyIdempotent

Shows an assignment's full instructions, attached files (with fileIds for read_file), links, rubric names, and the user's own submissions (with submissionFileIds for read_file) and feedback, including feedback files (with feedbackFileIds for read_file).

Inputs: course (required), assignment_id (required).

get_course_outlineCourse content outlineA
Read-onlyIdempotent

Shows a course's content tree (modules, lecture folders, slides, files, links, quizzes) with topicIds. Use search to filter by title (e.g. 'Lecture 5', 'week 6', 'uge 8', 'exercise'), or module_id for one folder; then the text on the matching modules' own pages is shown too, which often lists the week's reading, exercises and hand-in, with links. Then use read_file with a topicId to read a file.

Inputs: course (required), search, module_id, include_hidden.

get_topicContent item detailsA
Read-onlyIdempotent

Shows details for one content item (topicId from get_course_outline): description, dates, and the URL for links, videos and external tools such as Panopto. Use read_file instead to read the contents of a file.

Inputs: course (required), topic_id (required).

get_upcomingWhat's coming upA
Read-onlyIdempotent

Lists deadlines and dated items in the next N days across all courses (or one course): assignment due dates, quizzes, content with dates, and calendar events, which at DTU include timetable lectures and group work with rooms. Good for 'what do I need to do this week?'.

Inputs: days, course, include_completed.

list_assignmentsList assignmentsA
Read-onlyIdempotent

Lists a course's assignments (hand-in folders) with due dates and attachment counts, sorted by due date.

Inputs: course (required).

list_coursesList my coursesA
Read-onlyIdempotent

Lists the user's DTU Learn courses (current semester by default) with their ids. Use the course number or id with the other tools.

Inputs: include_past.

loginSign in to DTU LearnA
Read-onlyIdempotent

Signs in to DTU Learn. Only call this when other tools say the user is not signed in. If the user turned on automatic sign-in (saved password) this happens without a window; otherwise it opens a browser window on the user's computer where they sign in themselves (DTU login + MFA), so tell the user to look for it. Waits up to 5 minutes.

Inputs: no named parameters.

read_fileRead a course fileA
Read-onlyIdempotent

Downloads a file from DTU Learn to the user's computer and returns its text (PDF, PowerPoint incl. speaker notes, Word, notebooks, code, text). Give either topic_id (course content), assignment_id + file_id (assignment attachment), assignment_id + submission_file_id (a file the user handed in), assignment_id + feedback_file_id (a file in the user's feedback, e.g. their hand-in with the teacher's comments), or url (a DTU Learn link to a file, as shown in module pages, descriptions and instructions, e.g. https://learn.inside.dtu.dk/content/enforced/...). Long files are paged: use offset to continue. The saved path is returned so a coding agent can also open the original.

Inputs: course (required), url, offset, file_id, +5 more.

statusCheck DTU Learn connectionA
Read-onlyIdempotent

Checks whether you are signed in to DTU Learn and shows who you are signed in as. Use this first if other tools report authentication problems.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 10 tools

    Disambiguation5/5

    Each tool targets a distinct resource or action: authentication, course listing, outline navigation, upcoming deadlines, assignments, individual topics, file reading, announcements, and status. The potentially overlapping tools (get_upcoming vs. list_assignments, get_topic vs. read_file) are clearly differentiated by their descriptions.

    Naming Consistency4/5

    Most tools follow a predictable verb_noun pattern such as list_courses, get_assignment, read_file, and get_announcements. A few utilities (login, status) deviate from that pattern, and get_upcoming omits a noun, but the overall convention is still readable and consistent.

    Tool Count5/5

    Ten tools is well-scoped for an LMS access server, covering authentication, courses, content, assignments, files, deadlines, and announcements without obvious filler. Each tool earns its place in the workflow.

    Completeness4/5

    The surface covers core student read workflows: sign-in, course discovery, content browsing, assignment details, file reading, deadlines, and announcements. Minor gaps remain, such as assignment submission or grade retrieval, but agents can work around most of these for the stated access-oriented purpose.

    Maintenance

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      B
      maintenance
      Enables AI clients to read a student's own UGent Ufora (D2L Brightspace) data, including courses, announcements, deadlines, grades, course materials, and PDF text, over stdio or local Streamable HTTP. All operations are read-only and run locally against the student's authenticated session.
      19
      2
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Provides local, read-only access to Memorial University's Brightspace D2L courses, enabling students to view content, grades, assignments, quizzes, announcements, and deadlines through natural language.
      Apache 2.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Lets AI assistants read a student's Canvas LMS/Moodle courses, deadlines, announcements, grades and course files using their normal browser login instead of an access token. It is read-only and keeps all session data and downloads on the user's own machine.
      36 npm
      1
      MIT