Skip to content
MCP server

Brightspace

Read D2L Brightspace courses, grades, rubrics and calendar from an AI client

Runs locallyStatus and history
Install
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-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "brightspace": {
      "command": "npx",
      "args": [
        "-y",
        "brightspace-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "brightspace": {
      "command": "npx",
      "args": [
        "-y",
        "brightspace-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers