DTU Learn MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@DTU Learn MCP What's due in the next two weeks across all my courses?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
loginopens 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 loginA 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-mcpOr 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-learnSettings → 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-mcpAdd 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-passwordIt 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-passwordturns it off again;logoutalso removes it.statusshows 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 |
| Your current (or past) courses |
| 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) |
| 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 |
| Details and URL for links, videos (Panopto) and external tools |
| Deadlines and dated items in the next N days |
| Hand-ins with instructions, attachments, your submission status and feedback (your handed-in files and feedback files can be read with |
| Recent course announcements |
| 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 --helpTroubleshooting
"Not signed in" / "session has expired": run
npx -y github:frederikngh/dtu-learn-mcp loginagain. 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-passwordagain."Could not start a browser": install Chrome or Edge, or run
npx playwright install chromium."spawn git ENOENT" or similar: install Git;
npxneeds 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_upcomingshows 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 changeTest 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 toolsget_announcementsRecent announcementsBRead-onlyIdempotent
Shows recent announcements (news) from all courses, newest first.
Inputs: days, course.
get_assignmentAssignment detailsARead-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 outlineARead-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 detailsARead-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 upARead-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 assignmentsARead-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 coursesARead-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 LearnARead-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 fileARead-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 connectionARead-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
Scored across 10 tools
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.
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.
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.
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
Related MCP Connectors
Web search, data extraction and controlled browser automation for AI assistants via OAuth.
A real browser for your agent: screenshots, page checks, Markdown and PDFs.
Hosted browser for agents: open pages, search the web, extract data, read PDFs and take screenshots.
Control a real browser from AI agents: navigate, click, type, screenshot, read the page.
Related MCP Servers
- FlicenseNot gradedqualityBmaintenanceEnables LLMs to interact with a Brightspace account to retrieve courses, grades, due items, quizzes, course content, and files, including batch operations across multiple courses.-
- AlicenseBqualityBmaintenanceEnables 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.192MIT
- AlicenseNot gradedqualityBmaintenanceProvides 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
- AlicenseNot gradedqualityCmaintenanceLets 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 npm1MIT