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
This will automatically install Chromium for browser automation.
Setup
1. First-time authentication
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):
Available Tools
Assignments
Tool | Description |
| List all assignments with due dates and instructions |
| Get full details for a specific assignment |
| Get your submissions, grades, and feedback |
Course Content
Tool | Description |
| Get complete course syllabus/structure |
| Get details for a specific topic/lecture |
| Get main sections/modules of a course |
| Get contents within a specific module |
Grades & Calendar
Tool | Description |
| Get all your grades with scores and feedback |
| Get calendar events and deadlines |
Other
Tool | Description |
| Get course announcements from instructors |
| List all your enrolled courses |
| 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 |
| Your Brightspace hostname |
|
| 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-authif your session expires
Development
License
MIT
This server cannot be installed