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