d2l-mcp-server by bencered - MCP Server

D2L Brightspace MCP Server

An MCP (Model Context Protocol) server that provides AI assistants with tools to interact with D2L Brightspace LMS.

⚠️ WARNING! ⚠️

This server should not be used in any way to engage in academic misconduct. Do not use this MCP server to cheat on any assignments, or to gain an unfair advantage over other students. This server is only intended for use to enable agents to better understand your assignment scheduling and to help with your learning of the course material.

I do not condone the use of this server in any activities that would violate the user's university's Academic Code of Conduct.

Features

Automated SSO authentication via Playwright (handles Microsoft/institutional login)
Persistent session storage - login once, use for hours
12 tools for accessing assignments, grades, calendar, announcements, course content
File downloads with automatic text extraction (docx, txt, etc.)
LLM-optimized responses - clean, token-efficient output

Installation

npm install -g d2l-mcp-server

This will automatically install Chromium for browser automation.

Setup

1. First-time authentication

d2l-mcp-auth

This opens a browser window where you log in to Brightspace. Your session is saved to ~/.d2l-session/.

2. Configure Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "d2l": {
      "command": "d2l-mcp",
      "env": {
        "D2L_HOST": "learn.ul.ie",
        "D2L_COURSE_ID": "68929"
      }
    }
  }
}

Available Tools

Assignments

Tool	Description
`get_assignments`	List all assignments with due dates and instructions
`get_assignment`	Get full details for a specific assignment
`get_assignment_submissions`	Get your submissions, grades, and feedback

Course Content

Tool	Description
`get_course_content`	Get complete course syllabus/structure
`get_course_topic`	Get details for a specific topic/lecture
`get_course_modules`	Get main sections/modules of a course
`get_course_module`	Get contents within a specific module

Grades & Calendar

Tool	Description
`get_my_grades`	Get all your grades with scores and feedback
`get_upcoming_due_dates`	Get calendar events and deadlines

Other

Tool	Description
`get_announcements`	Get course announcements from instructors
`get_my_courses`	List all your enrolled courses
`download_file`	Download and extract content from course files

Example Prompts

Once connected to Claude, you can ask things like:

"What assignments are due this week?"
"Show me my grades"
"What announcements have been posted?"
"Download the weekly report template"
"What's the syllabus for this course?"

Environment Variables

Variable	Description	Default
`D2L_HOST`	Your Brightspace hostname	`learn.ul.ie`
`D2L_COURSE_ID`	Default course ID (optional)	none

Setting D2L_COURSE_ID allows you to omit the course ID from tool calls.

Session Management

Token expiry: Auth tokens expire after ~1 hour but auto-refresh using the saved browser session
Session expiry: Browser sessions expire after ~24h of inactivity
Re-authenticate: Run d2l-mcp-auth if your session expires

Development

# Run tests
npm test

# Run integration tests (requires auth)
npm run test:integration

# Watch mode
npm run test:watch

License

MIT