Brightspace
Read D2L Brightspace courses, grades, rubrics and calendar from an AI client
- Platforms
- CLI, self-hosted, macOS
- Runs
- Locally
- Version
- 1.3.2
- Listing updated
- today
Similar MCP servers
About Brightspace
Brightspace is an MCP server for education and exams. It runs locally on your machine and is started by your AI client.
Brightspace MCP reaches into a student or instructor account on a D2L Brightspace site, covering courses, grades, assignments, rubrics, feedback, course files and the calendar. Setup is built around a wizard that asks for your school's base URL, picks an authentication method and registers the server with Claude Desktop, Cursor or Windsurf.
Authentication is the unusual part. It supports an API token, a headless username and password login, a Playwright-driven browser login for SSO such as Microsoft Azure AD, and pasted session cookies. MFA can be TOTP, Duo Push, or a manual prompt. Config lives in a YAML file where secrets are env references, and sessions can be cached in memory, a file or Redis.
Output timezone, locale and format are configurable, and write operations such as submitting or posting are documented separately. A Docker image, a terminal dashboard and a daily update check are also described.
Install
Run in a terminal
claude mcp add brightspace -- npx -y brightspace-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"brightspace": {
"command": "npx",
"args": [
"-y",
"brightspace-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"brightspace": {
"command": "npx",
"args": [
"-y",
"brightspace-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"brightspace": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"brightspace-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"brightspace": {
"command": "npx",
"args": [
"-y",
"brightspace-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"brightspace": {
"command": "npx",
"args": [
"-y",
"brightspace-mcp"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
BRIGHTSPACE_CONFIGPath to config.yaml. Default: ~/.brightspace-mcp/config.yaml
What it does
- Several login strategies
- API token, headless login, browser SSO via Playwright or session cookie.
- MFA support
- TOTP, Duo Push polling or a manual code prompt.
- Setup wizard
- Walks through base URL, auth and registers with Claude Desktop, Cursor and Windsurf.
- Configurable output
- Choose IANA timezone, locale (en-US, es-419, pt-BR, fr-CA) and markdown or plain text.
- Optional Redis cache
- Session cache backend can be memory, file or Redis.
- Docker and TUI
- Runs in a container and includes a terminal dashboard.
Good for
- Ask what assignments are due this week
- Check grades and rubric feedback across courses
- Pull course files into an AI summary
- Review the Brightspace calendar by deadline
Brightspace FAQ
Which Node version is required?
Node.js 20 or newer.
Can it handle school single sign-on?
Yes, the browser strategy automates SSO logins and has a Microsoft SSO preset.
Which MFA methods work?
TOTP, Duo Push and a manual prompt where you paste the code.
How do I start it?
Run npx brightspace-mcp@latest setup for the wizard, then serve.
How do I add Brightspace to Claude Code?
Run this command in your terminal: claude mcp add brightspace -- npx -y brightspace-mcp
What are the best alternatives to Brightspace?
The closest alternatives to Brightspace are Ha MCP, Concord MCP, note1, Zovo Org Chart Maker and Google Workspace MCP Server.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.
