brightspace-mcpTalk to D2L Brightspace from any MCP client

Multi-auth, opt-in writes, rubrics & real feedback, course files in any format, MCP Resources & Prompts, i18n. 1051 tests · 91.52% line coverage.

Get started

Tools reference

View on GitHub

🔐

Five auth strategies

api_token, browser (Playwright + SSO presets), headless, oauth, session_cookie. TOTP, Duo Push, FIDO2/biometric via record-auth.

Choose your strategy

📚

31 MCP tools + Resources + Prompts

Courses, grades, assignments with rubrics and real feedback, content (PDF, Office, notebooks, images, module descriptions), syllabus finder, your own submitted files, quizzes, calendar, announcements. Plus stable brightspace:// URIs and prompt templates.

Browse the catalog

✍️

Opt-in writes

Submit assignments, post discussion replies, mark announcements read. Gated behind --enable-writes with idempotency and audit log.

Enable writes

🌍

Localized output

Dates and text in your language — en-US, es-419, pt-BR, fr-CA. Timezone-aware Markdown output. Configured in setup wizard automatically.

Configure locale

🖥️

Terminal dashboard

`brightspace-mcp tui` opens a full-screen dashboard — upcoming work, courses, calendar, config editor, cache and logs.

Open the TUI

🧱

DDD-clean architecture

Bounded contexts enforced by dependency-cruiser. Domain layer is pure TypeScript, no infra leakage. 1051 tests, 91.52% line coverage.

Read architecture

Quick install

bash

npx brightspace-mcp@latest setup   # interactive wizard
# or non-interactive (CI/DevContainers):
npx brightspace-mcp@latest init --base-url https://... --strategy browser --preset microsoft
brightspace-mcp doctor              # verify setup

Add to your MCP client (Claude Desktop, Cursor, Windsurf, …) — see Clients.

Why brightspace-mcp?

D2L Brightspace doesn't ship with a friendly API for daily student / TA workflows. This MCP server bridges that gap so an LLM agent can:

Read your courses, syllabus, content, announcements, grades, quizzes, and discussions
Write carefully — submit assignments, reply to discussions — only when you opt in
Adapt to any institution via YAML profiles and auth presets, no code changes
Browse content via stable brightspace:// MCP Resources and pre-built prompt templates
Manage everything from a terminal dashboard (brightspace-mcp tui)

It's a portable alternative to scripting against Valence by hand — it tells you when it's outdated (and when a security update is due), with SemVer stability from v1.0.0 onward.

Status


Latest version	v1.3.2
Tests	1051/1051 passing
Coverage	91.52% lines / 90.93% functions
Node	≥ 20 (tested 20, 22)
OS	macOS, Linux, Windows
License	MIT