# Brightspace

> Brightspace is an MCP server for education and exams. Read D2L Brightspace courses, grades, rubrics and calendar from an AI client. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI, self-hosted, macOS, Windows, Linux
- **Repository:** https://github.com/jhostinaleck/brightspace-mcp
- **MCP Registry name:** io.github.JhostinAleck/brightspace
- **Categories:** [education and exams](https://ai-powered.com/categories/education-and-exams), [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add brightspace -- npx -y brightspace-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "brightspace": {
      "command": "npx",
      "args": [
        "-y",
        "brightspace-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "brightspace": {
      "command": "npx",
      "args": [
        "-y",
        "brightspace-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "brightspace": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "brightspace-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "brightspace": {
      "command": "npx",
      "args": [
        "-y",
        "brightspace-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "brightspace": {
      "command": "npx",
      "args": [
        "-y",
        "brightspace-mcp"
      ]
    }
  }
}
```

## 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.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [Zovo Org Chart Maker](https://ai-powered.com/mcp/zovo-org-chart-maker): Zovo Org Chart Maker is an MCP server for productivity.
- [Google Workspace MCP Server](https://ai-powered.com/mcp/google-workspace-mcp-server-2): Google Workspace MCP Server is an open-source MCP server for productivity.
- [InviteKit Calendar Files](https://ai-powered.com/mcp/invitekit-calendar-files): InviteKit Calendar Files is an MCP server for files and documents.
- [Penline Handwriting Sheets](https://ai-powered.com/mcp/penline-handwriting-sheets): Penline Handwriting Sheets is an MCP server for education and exams.
- [Google Workspace MCP](https://ai-powered.com/mcp/google-workspace-mcp-2): Google Workspace MCP is an MCP server for productivity.

---
Source: https://ai-powered.com/mcp/brightspace
