brightspace-mcpTalk to D2L Brightspace from any MCP client

Multi-auth, opt-in writes, MCP Resources, MCP Prompts, web dashboard, i18n. 743 tests · 89% coverage.

Five auth strategies

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

Choose your strategy

📚

26 MCP tools + Resources + Prompts

Read courses, grades, assignments, content, quizzes, calendar, discussions. Plus stable brightspace:// URIs and pre-built 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

🖥️

Web dashboard

`brightspace-mcp ui` opens a local dashboard — auth status, upcoming due dates, grades, config editor, cache stats, audit logs.

Open dashboard

🧱

DDD-clean architecture

Bounded contexts enforced by dependency-cruiser. Domain layer is pure TypeScript, no infra leakage. 743 tests, 89% 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 local web dashboard (brightspace-mcp ui)

It's a portable, self-updating alternative to scripting against Valence by hand — with SemVer stability from v1.0.0 onward.

Status


Latest version	v1.1.0
Tests	743/743 passing
Coverage	89% lines / 88% functions
Node	≥ 20 (tested 20, 22)
OS	macOS, Linux, Windows
License	MIT